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Preface 



This publication describes the ibm 7040/7044 Input/ 
Output Control System, hereafter referred to as iocs, 
and the methods by which the programmer can use 
the system to increase the efficiency of his programs 
and decrease the time necessary for writing and test- 
ing them. Because iocs can be used in three distinct 
ways, the publication consists of a general introduction, 
one chapter on each of the three main levels of iocs, 
and a chapter on the label handling facilities of the 
system. It is suggested that the user read the introduc- 
tion and the chapter describing the section of iocs that 
most interests him. 

The use of this iocs requires a 7040/7044 Data Proc- 
essing System that has an extended performance in- 
struction set, 16, 384 or more words of core storage, and 
at least the minimum of input/output units required by 
the 7040/7044 Operating System. 

The reader must be familiar with the ibm 7040/7044 
Data Processing Systems, the principles of coding for 
symbolic assembly programs, and the use of the Op- 
erating System. To satisfy these requirements, the 
reader should be familiar with the contents of the 
following publications: 

IBM 7040/7044 Systems Summary, Form A28-6289 

IBM 7040/7044 Principles of Operation, Form 
A22-6649 

IBM 7040/7044 Operating System (16/32): Program- 
mers Guide, Form C28-6318 

IBM 7040/7044 Operating System ( 16 /32K): Macro 
Assembly Program (MAP) Language, Form C28-6335 



Major Revision ( July 1964 ) 

This edition, Form C28-6309-3, supersedes the previous edition, 
Form C28-6309-2, and associated Technical Newsletters, Forms 
N28-0500 and N28-0506. It includes a discussion of the tele- 
processing capabilities added to the Input/Output Control 
System for the 1414 Input/Output Synchronizer, Models IV and 
V. Changes are indicated by a vertical line placed to the left 
of the affected text. 
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Introduction 



The purpose of an input/output control system is to 
reduce the amount of time spent by the programmer 
in writing and testing the input/output portions of his 
programs. To perform this function, iocs acts as an 
intermediary between the object program and the 
input/output devices attached to the computer, and 
allows installation and system control over input/ 
output units and operations. 

Most input/output routines require coding effort 
disproportionate to the part played by input/output 
in the logic of the program. They also constitute a 
major source of errors and often require numerous de- 
bugging runs. The iocs removes both difficulties by 
providing the programmer with a simplified program- 
ming environment that closely fits the logical input/ 
output requirements of his program and by providing 
pretested routines to substitute for coding that he 
would ordinarily have to supply. 



Basic Concepts 

The following sections form a general description of 
the input/output characteristics of the ibm 7040/7044 
Data Processing Systems and contain the definitions 
of many terms that occur throughout this publication. 
To the experienced programmer, many of the explana- 
tions will be elementary, but some of the terms being 
defined have restricted uses for the purposes of this 
publication. For this reason, programmers who are 
thoroughly familiar with the subjects under discussion 
may find it useful to read the sections that follow for 
the definitions of terms. 

File 

One of the basic concepts of data processing is the file. 
A file is a collection of related data. It may be recorded 
on cards, magnetic tape, disk storage, or some other 
recording medium. It is important to maintain a dis- 
tinction between the file and the recording medium on 
which it resides. 

A file is recorded as a series of blocks, or physical 
records, in the recording medium. Each block may con- 
tain one or more data records. 

The data record is the basic unit of information 
for a data processing program. It consists of a single 
datum, or piece of information, from a file. A data 
record may be a single number, it may be all of the 
information pertaining to a given business transaction, 



or it may be a record of the value of several parameters 
at a given point in an experiment. The logical structure 
of most data processing programs consists of reading, 
processing, and writing individual data records. For 
this reason, data records are sometimes termed logical 
records. 

Because of the characteristics of the various input/ 
output units on which a file may be held, the problems 
of transforming data from physical records on one 
unit, to data records in core storage, and back to physi- 
cal records on another unit, can become fairly com- 
plicated. One of the advantages of using iocs is the 
ability to read and write physical records on the var- 
ious input/output units almost interchangeably. It is 
for this reason that the concepts of "file" and "data 
record" must be independent of the device used. 

Throughout this publication, the term end of data 
file will be used for the actual end of the data file. The 
"end of file" on a card reader, for instance, indicates 
that all of the cards in the hopper have been read; but 
the file to which these cards belong may be continued 
on a magnetic tape unit or on some other device. 

The storage capacities of such devices as magnetic 
tape units and disk storage are finite, as contrasted with 
card punches, which can write unlimited amounts of 
data, provided that the hopper is kept filled with blank 
cards. When no more data can be written on a mag- 
netic tape or disk storage unit, the end of medium is 
said to have been reached. If data remains to be written 
in the output file that is being placed on this primary 
unit, the writing must take place on an alternate unit. 
To accomplish this, the primary and alternate units are 
switched, iocs greatly simplifies the process of unit 
switching. 

The only alternative to unit switching on 729/7330 
magnetic tape units is changing tapes on the same unit. 
This process is extremely costly in terms of time, since 
the computer is usually idle while the operator is 
changing the tape. 

Labels 

A label is a record that identifies a file, or part of a file. 
Labels come at the beginning and end of each segment 
of the file. The first label of each segment is the header . 
label, and the second is the trailer label. 

Labels are used to distinguish among the various 
segments of a file. For example, if a file is held on 
five reels of magnetic tape, the header labels indicate 
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the order in which the reels should be read, and the 
trailer label on each reel indicates whether or riot the 
file has come to an end. Each reel before the last has 
an end-of-reel trailer label. The last reel ends in an 
end-of-ftle trailer label. 

Labels also contain such information as the record- 
ing mode of the file, the length of time that the file is to 
be retained, and the date on which the file was created. 



Data Channels and Overlap 

The devices that control the transmission of data from 
the central processing unit to the various input/output 
units are the data channels. All 7040 and 7044 Data 
Processing Systems are equipped with at least one data 
channel ( channel A ) . Up to four more ( channels B-E ) 
may be added as optional features. 

Central processing unit operation is suspended while 
information is being transmitted between core storage 
and an on-line 1401 or a 1414 Input/Output Synchro- 
nizer on channel A. This is called nonoverlapped op- 
eration. Channels B through E, however, allow central 
processing unit operation to occur simultaneously with 
input/output operation on one or more of them. This 
overlap of processing and input/output allows the 
main program to read ahead on a file, that is, to read 
data records into core storage while previously read 
data records are being processed. It also allows the 
program to process data records while previously proc- 
essed data records are being written out from core 
storage. 

The user of iocs need not concern himself with the 
differences between channel A and channels B-E, ex- 
cept when he is programming at the ioex level of iocs, 
described in the chapter "Input/Output Executor 

( IOEX ) ." 



Buffers 

Each physical record must be read into or written out 
from a set of consecutive locations in core storage. 
These input/output areas are called buffers. Each 
buffer contains exactly one physical record, although 
the record may not always fill the buffer completely. 

It is necessary to have more than one buffer for each 
file being read or written, if overlapping is to be used. 
One buffer holds the information that is in the process 
of being read or written and the other(s) holds the 
data being processed. 

The data (i.e., logical) records in each block of an 
input file must be separated and presented to the 
processing sections of the program one at a time. This 
process is known as deblocking. 



A buffer is refilled after all of the data records have 
been removed from it. As soon as processing of all the 
data records in a given buffer has been completed, the 
buffers reverse roles, from read-in buffer to current 
buffer (i.e., the buffer from which data records are 
being extracted ) . This is buffer switching. 

One or more output data records, created by the 
processing section of the program, are placed in a 
buffer (blocking). When a given buffer can hold no 
more data records, its contents are written out and 
buffers are switched, so that another buffer is ready 
to accept further data records while the preceding rec- 
ords are being written out from the first buffer. 

The iocs provides tested routines to block and un- 
block data records, to switch buffers as each one be- 
comes empty or full, and to initiate the reading and 
writing necessary to maintain a continuous flow of 
information. 

It is not usually necessary for the programmer to 
reserve his own buffers, provided that he is using the 
relocatable Loader and the buffer processing routines 
of iocs. The relocatable Loader ( ibldr ) has provisions 
for creating the buffers necessary for iocs use when the 
object program is being loaded into core storage. ( The 
publication IBM 7040/7044 Operating System (16/ 
32K): Programmers Guide, Form C28-6318, contains 
detailed information on this process.) This is normally 
done from the specifications of each file, given by the 
programmer. 



Structure of IOCS 

The 16/32K Input/Output Control System is a col- 
lection of routines, located in the lower part of core 
storage. It is divided into five sections. 

The Input/Output Buffering System ( iobs ) contains 
the routines that perform the blocking, deblocking, 
and buffer switching operations of iocs. The features 
of iobs largely relieve the programmer of the necessity 
of considering the characteristics of the medium on 
which each of his files is recorded. They allow him to 
concentrate on the processing steps in his program, by 
providing or accepting individual data records. 

Input/Output Operations ( ioop ) performs all of the 
reading, writing, and non-data-transmitting operations 
required by iocs. The ioop level consists of two sec- 
tions: ioopi contains the calling sequence interpreta- 
tion routine, the unit synchronizer routine, and the 
select and error-recovery routines for 729/7330 mag- 
netic tape units and 1301 Disk Storage or 7320 Drum 
Storage; ioop2 contains the select and error-recovery 



routines for the 1009 Data Transmission Unit, the 1011 
Paper Tape Reader, the 1014 Remote Inquiry Unit, the 
1402 Card Read Punch, the 1403 Printer, the 1622 Card 
Read Punch, and telegraph units. 

The Input/Output Label System (iols) performs 
unit switching, verifies and creates ibm standard labels, 
and uses ioop to read and write labels. 

The Input/Output Executor ( ioex ) attends to data 



channels traps, schedules the use of the data channels 
for input/output operations, schedules the use of the 
central processing unit for programs of various prior- 
ities, and services central processing unit traps. 

The order in which the sections of iocs reside in core 
storage is shown in Figure . 1. 

If the storage protection optional feature is avail- 
able to the system, it is used to protect at least the 
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Figure 1. Arrangement of the Parts of the Input/Output Control System 
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portions of iocs used by the System Loader ( s.sldr ] 
ioex and ioopi. 



Levels of IOCS 

The structure of iocs permits three distinct approaches 
to input/output programming. The sections of iocs that 
form the three levels of iocs are shown in Figure 2. 
The shaded blocks indicate the section with which 
the object program communicates. 

The programmer should choose one level of input/ 
output programming for each file being processed and 



should use that level exclusively for all input/output 
operations required for that file. The use of two or 
more levels of iocs on a given unit may, result in errors. 
In general, it is recommended that the highest level 
of iocs consistent with the size and jnput/output re- 
quirements of the program be used. However, there 
are certain restrictions placed on the choice of iocs 
levels to be used by the programmer. A no-priority 
object program may call any iocs routine; a special 
routine may not call iobs or iols; a non-standard 
select and error-recovery routine may not call iobs, 
iols, or ioop. 
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7040/7044 



The IOBS Level 
Figure 2. The Internal Structure of iocs 
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The IOOP Level 



The IOEX Level 



IOCS and the Operating System 

The programmer can specify tor the Loader (ibldr) 
~the level of iocs that is used by his object program. 
The loader uses this information to relocate the origin 
of the program to a point above the end of the highest 
section of iocs being used, while taking into account 
the fact that the origin of the program cannot be within 
a protected part of core storage. 

To increase the flexibility of the Data Processing 
System and to speed job-to-job transition, the input/ 
output units that are read and written by iocs are des- 
ignated symbolically, rather than by actual addresses. 
The symbolic units are listed in Figure 3. The cor- 
respondence between an actual input/output device 
and a symbolic unit is specified by a series of tables 
in the Nucleus of the Operating System. The operator 
can vary this correspondence by using System Monitor 
control eards; or the entry keys. 



The number of utility units at an installation is de- 
termined at system assembly. 



Symbol 


Unit 


S.SLB1 


System Library Unit 1 


JS.SLB2 


System Library Unit 2 


S.SOU1 


System Output Unit 1 


S.SOU2 


System Output Unit 2 * 


S.SIN1 


System Input Unit 1 


S.SIN2 


System' Input Unit 2 


S.SPP1 


System Peripheral Punch Unit 1 


S.SPP2 


System Peripheral Punch Unit 2 


S.SCK1 


System Checkpoint Unit 


S.SU0O 


Utility Unit 6 (available to the object program) 


S.SU01 


Utility Unit 1 (available to the object program) 


S.SU99 


Utility Unit 99 (available to the object program) 



Figure 3. Table of Symbolic Units 
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Input/Output Buffering System (IOBS) 



The Input/Output Buffering System (iobs) allows the 
programmer to use a logical approach to his file proc- 
essing requirements. After the physical arrangement 
of each file has been specified, the programmer simply 
requests input or output of data records. The iobs 
blocks and deblocks data records, switches buffers, and 
reads and writes physical records, as required. 



Use of IOBS 

The first step in the use of iobs is file' description. Files 
may be described in the programmer's coding through 
the file and label pseudo-operations of the Macro 
Assembly Program language. If the files are unlabeled, 
only the file pseudo-operation need be iised. Each 
labeled file, however, requires a label pseudo-opera- 
tion immediately following the file description. 

The programmer may choose to describe hjs files at 
load time, rather than at assembly time. He may also 
wish to change certain options that were specified by 
file pseudo-operations. In either case, he may use the 
Loader (ibldr) control cards $file and slabel. The 
specifications in these cards override certain pre- 
• assembled specifications, and $file and $label cards 
for files that are not as yet specified perform the same 
function as file and label entries in the map coding. 
The file and label pseudo-operations are described 
in the publication IBM 7040/7044 Operating System 
(16/32K): Macro Assembly Program (MAP) Language, 
Form C28-6335. The sfile and slabel control cards, 
and the spool control card ( discussed later ) , are de- 
f scribed in the public®f§gj| v ZBM 7040/7044 Operating 
System: Programmers &uide, Form C28-6318. 

At load time, when the object program is being 
relocated by the Loader, the label and file-description 
information about each file is translated into a file con- 
trol block. The location of the first word of the file 
control block replaces the name of the file in the user's 
coding. The file control block contains both permanent 
information, such as labeling data, and temporary in- 
formation, such as the location of the first word of the 
next data record to be processed. \y- 

Also at load time, the specifications of the various 
files are inspected to determine the size and number 
of buffers required. Ordinarily, one buffer of appro- 



priate size is created for each single-buffered file, and 
two buffers are created for each double-buffered file. 
If the user wishes, however, he may cause fewer than 
the usual number of buffers to be created for a group 
of files that have approximately the same buffer size 
requirements. This is done by the use of the spool 
Loader control card. The spool card specifies the size 
of the individual buffers, the total number of buffers 
to be created, and the files that will use these buffers. 
As each file is opened, it is assigned one or two buffers 
from the pool, depending on whether it is single- or 
double-buffered. When it is closed, the buffers are 
returned to the pool. The number of buffers in the 
pool need only be equal to the maximum number of 
buffers required by the files in the pool that are open 
simultaneously. If some of the files are closed before 
others are opened, some buffers may be used by two 
or more files, considerably reducing the space required. 

The format of a buffer pool is: 



pool 
list 



areal 
area2 



PZE 
PZE 
PZE 



PZE 
BSS 
BSS 



BSS 



list„m 

areal + l„length 

area2 + l„length 



aream + l„length 
length +2 
length +2 



length +2 



where: 



is the number of buffers in the pool. 

length 

is the length of each buffer, including Type 2 and 3 data 
record control words and the check sum/block sequence num- 
ber word ( if any ) . 

Only the elements of the list need be in consecutive 
core storage locations. 



File Control Blocks 

Each file control block contains 19 words of informa- 
tion concerning a specific file. This information is used, 
during the processing of the file, both by the main 
program and by iobs. The format of the file control 
block is shown in Figure 4. 
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1. FCCUR 



2. FGLNG 



3. FCRCT 



4. FCNXT 



5. FCCBF 



6. FCPLC 



7. FCBUF 



8. FCUNI 



9. FCFCN 



10. FCCON 



11 . FCBSN 



12. FCFSN 



13. FCRSN 



14. FCRET 



15. FCID1 



16. FCID2 



17. FCEXI 



18. FCNAM 



19. FCERC 



s 


1 


2 


3 


4 


5 


6 


7 ] 


,8 


9 


10 


1 1 


12 


13 


14 


15 


16 


RT 









































RCT 

Number of data records per block 



21/22 23 24 25 26 27 28 29 30 31 32 33 34 35 



Address of the first word of the 
current data record 



Length of the current data record 



Number of data records which remain to be 
processed from the current block 






Address of the control word of the buffer 
being read or written 






UN2 

Address of the Symbolic Units Table entry 

of the secondary unit * : '.-■■"' 



Reserved 



M 



DB 



ERR ' 

Address of user's error correction 
routine, if any * 




Starting address of the current data 
record, plus its length 



Address of the last data word in the 
current buffer, plus one 



PLC 

Address of the buffer pool control 

word for this file * 



Address of the control word of the 
current buffer 



UNI 

Address of the Symbolic Units fable 

entry of the primary unit * 



FCN 

Address of a nonstandard or additional 

label processing routine * 



BLK 

Block' size ( = buffer size less buffer control word, 
extra word in case of error, and block sequence/check 
sum word)* . - 



Number of blocks read or written 



FSN 

File serial number, in BCD, of the form OXXXXX* 



RSN 

Reel sequence number, in BCD, of the form OOXXXX * 



RET , ' ? .;■■ ■ 

For an output file, the retention period (days) in BCD, of the form OOXXXX * 

For an input file, the file creation date in BCD, of the form OXXXXX * 



ID1 

First six characters of the BCD file identification, of the form XXXXXX * 



ID2 

Last four characters of the BCD file identification, of the form XXXX00 * 






EOF 

Address of the user's end-of-data-file 
111 routine for this file * 



. , — 



EOR 

Address of the user's end-of-reel 

routine for this file, if any * 



NAM 

File name in BCD * 



Number of permanent errors 



Number of recovered errors 



Fields marked with an * must be set before any IOCS routine is used. 
Figure 4. Format of the File Control Block 
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The fields in the file control block are set as follows: 



FIELD 

RCT 
PLC 

UNI 

UN2 

FCN 

BLK 

ERR 

FSN 

RSN 

RET 

ID1 

ID2 

EOF 

EOR 

NAM 



SET BY FILE DESCRIPTION 

Record Count Option 

Set by the Loader 

Unit Assignment Options 

Unit Assignment Options 

Labeling Option 

Blocksize Option 

Error Exit Option 

Labeling information ( if any ) 

Labeling information ( if any ) 

Labeling information (if any) 

Labeling information ( if any ) 

Labeling information ( if any ) 

End-Of-File Option 

End-of-Reel Option 

Set by the Loader 



The explanations of the two-character bit codes in 
the file control block are shown in Figure 5. 



Checkpoints 

A checkpoint is a recording of the status of the com- 
puter at a given point in the execution of the program. 
It contains all of the information necessary to restart 
the program from that point. 

The checkpoint routine is part of the subroutine 
library of the ibm 7040/7044 Processor (16/32K). Any 
program that requires checkpoints to be taken must 
cause the checkpoint routine to be included among 
the routines loaded with the object program. This can 
be done by the use of the map macro-instruction 
chkpnt, which must be executed before any files are 
opened. The chkpnt macro-instruction does not cause 
a checkpoint to be taken. It simply communicates to 
iocs the location of the entry point to the checkpoint 
routine. If the user does not choose to use this macro- 
instruction, he must place the location of the check- 
point routine in s.sckt himself. 

The checkpoint routine can be used in two ways. 
The programmer can specify in the file control block 
for each file whether or not he wants checkpoints to 
be taken when the file is opened and whenever units 
are switched. Checkpoints can also be taken at arbi- 
trary points in the program, by the use of the following 
calling sequence: 

TSX S.CKPT.4 

After the checkpoint has been written on the check- 
point file, control is returned to the calling program by 
a tra 1,4. If checkpoints are to be taken on the check- 
point file, the object program must provide a file control 
block for this file and must open the checkpoint file 
before the checkpoint routine is used, either directly 
or indirectly. If the user is assembling his own file con- 
trol blocks, rather than using file macro-instructions 



or $file control cards, and checkpoints are to be taken 
on any of these files, he must place the location of the 
first word of his string of file control blocks in s.sfbl. 

The restarting of a program from a checkpoint is 
usually an externally initiated procedure, requiring 
operator action. Restart procedures are described in 
the publication, IBM 7040/7044 Operating System: 
Operator's Guide, Form C28-6338. 



Block Sequence Numbers and Check Sums 

The iobs can provide two kinds of internal checks on 
the validity of binary physical records: block sequenc- 
ing and the use of check sums. 

Whenever iobs writes a physical record of a file that 
has either block sequence numbers or check sums (or 
both) specified in its file control block, an extra word 
is appended to the record before it is written. If block 
sequencing is specified, the number of the block, main- 
tained in word fcbsn of the file control block, is placed 
in the address portion of the extra word. If check sums 
are specified, iocs takes a logical sum of all of the words 
of the block [using an Add and Carry Logical (acl) 
instruction], adds together the right and left halves of 
this sum by the same method, and places the resulting 
18-bit folded check sum in the first 18 bits of the extra 
word. 

When a block that is part of a file using block se- 
quencing or check sums is read, its last word is checked. 
If block sequence numbers are specified in the file con- 
trol block, the address portion of the check sum/block 
sequence number word is compared with the address 
of word fcbsn. If the two are not equal, an error return 
(discussed under "iobs Error Procedures" ) is taken. 

If check sums are specified for an input file, a check 
sum is taken of each block as it is read, and the result 
is compared with the first 18 bits of the last word of 
the record. If the two are not equal, an error return is 
taken. 



Record Formats 

The iobs can process both fixed-length and variable- 
length data records. The data record type and the 
length (or maximum length) of each data record is 
given in the file control block. 

Type 1 data records are fixed-length records. The 
user's program can change the data record length field 
in the file control block to allow the processing of non- 
standard formats. 

Type 2 and Type 3 data records are standard format 
variable-length data records, in which the length and 



12 



Bit 








Bit 








Code 


Description 


Explanation 


Set by 


Code 


Description 


Explanation 


Set by 


RT 


Record 


= 00 for Type 1 records. 


Record 






= 1 on an. output file, if 






Type* 


— 10 for Type 2 records. 
= 11 for Type 3 records. 


Type 
Option 






a checkpoint is to be 
written following every 




TB 


Truncation 


= if the current buffer 


IOBS 






header label. 






Bit 


is not to be truncated 
on the next entry to 
the IOBS for this file. 
= 1 if the current buffer 
is to be truncated on 
the next entry. 




CP 


Checkpoint* 


= if no checkpoints are 
to be taken on the 
checkpoint file for this 
file. 

= 1 if a checkpoint is to 
be taken on the check- 


Checkpoint 
Options 


IG 


Ignore Get 


= if no error exit was 
taken for error type 4 
or 10. 

= 1 if error exit was taken 


IOBS 






point file when this file 
is opened and when- 
ever units are switched 
on this file. 


' 






for error type 4 or 10. 




CB 


Checkpoint 


= if this is not the 


Checkpoint 


MU 


Mixed Unit 


= if file is not defined 


IOBS 




File* 


checkpoint file. 


File 




Record 


as unit record Type 3. 
= 1 if file is defined as 








= 1 if this is the check- 
point file. 


Option 






unit record Type 3. 




Dl 


Density 


= if the file is in low 


File 


OB 


Open 


= if the file is not open. 


IOBS 




Indicator** 


density. 


Density 




Status Bit 


= 1 if the file is open. 








— 1 if the file is in high 


Option 


Rl, R2 


These bits are 


reserved for future use 








density. 






by DS Programming Systems. 




LF 


List File** 


= if the file is to be 


File 


SI 


Secondary Unit 


= if a mounting mes- 


Mounting 






listed at the end of 


Disposition 




Deferred 


sage for the secondary 


Option 






the job. 






Mounting 


unit is not to be typed 








= 1 if the file is not to 






Message* 


when a reel switch 








be, listed. 








occurs. 




Ml 


Mode 


= if the file is in BCD 


IOBS 






— 1 if a mounting mes- 






Indicator 


mode. 








sage for the secondary 








= 1 if the file is in' bin- 








unit is to be typed 








ary mode. 








when a reel switch 




RS 


Reel 


= if the file is single- 


Reel 






occurs. 






Specification* 


reel. 


Handling 


PR 


Permissible to 


= permissible to reposi- 


IOLS 






= 1 if the file is multi- 


Option 




Reposition 


tion at CLOSE. 
= 1 do not reposition at 
CLOSE. 








reel. (Unlabeled files 
only) 












LI 


Labels 


= if the file is un- 


Presence of 


PI 


Primary Unit 


= if a mounting mes- 


Mounting 




Indicator* 


labeled. 


Label Card 




Deferred 


sage for the primary 


Option 






— 1 if the file is labeled. 






Mounting 


unit is not to be typed 














Message* 


when the file is opened. 




SC 


Sequence 


= if no block sequence 


Block 






= 1 if a mounting mes- 
sage for the primary 






Check* 


numbers are to be 


Sequence 












formed or checked for 
this file. 


Option 






unit is to be typed 














when the file is opened. 








= 1 if block sequence 




NA 


Nonstandard or 


= if the label is a 


Labeling 






numbers are to be 






Additional 


, standard IBM label 


Option 






formed .. o.r checked for 






Label 


and is to be verified 








this file. 






Processing 


by IOCS. If the ad- 




CC 


Check Sum 


= if no check sums are 


Check 






dress in bits 21-35 of 






Check* 


to be formed or 


Sum 






this word is not zero. 








checked for this file. 


Option 






this address is the 








— 1 if a check sum is to 








location of the entry 








be formed or checked 








point to an additional 








for each record writ- 








processing routine. 








ten or read on the file. 








= 1 if the label is not a 




DB 


Disposal 


= 00 if the file can be 


File 






standard IBM label and 






Bits** 


destroyed at the end 


Disposition 






is not to be verified by 








of the job. 








IOCS. The label is read 








= 01 if the file is to be 








into and written from 








printed at the end of 








the label area. If the 








- the job. 








address in bits 21-35 








= 10 if the file is. to be 








of this word is not zero. 








punched at the end of 








this address is the loca- 








the job. 








tion of the entry point 








= 11 if the file is to be 








to a nonstandard veri- 








held at the end of the 








fication or creation 








job. 








routine. 




PB 


Prime 


= do not prime buffers. 


IOBS 


IN 


Input 
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= 1 if the file is input. 
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Buffers 


= 1 prime buffers at first 
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OU 


Output 
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put. 
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= if the file is single- 
buffered. 
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Buffer 
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Fields marked with an * must be set before any IOCS routine is used.- Bits marked with a 
interpreted by IOBS. They are used by some other part of the Operating System. 

Figure 5. Explanation of File Control Block Bits 
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recording mode (BCD/binary) of the record are speci- 
fied in the record itself. 

The first word of each Type 2 or Type 3 data record 
specifies the kind and amount of information in the 
record. The first word of a binary Type 2 or Type 3 
data record is of the form: 



101 


n 


010 




X 



S 2 3 

where: 



17 18 20 21 



29 30 



35 



is the number of words in the data record, excluding the con- 
trol word itself, 
x 

is one of the control characters listed in Figure 6. 

The prefix and the tag in this word are ignored by iobs. 
They are included for compatibility with other sys- 
tems. 

The first word of a bcd Type 2 or Type 3 data record 
is of the form: 



Control 






Indicates that The 


Character 




Indicates that This Record Is: 


Next Record Is: 


2 


a 


BCD record to be printed. 


BCD. 


3 


a 


BCD record to be printed. 


binary. 


4 


a 


BCD record to be punched. 


BCD. 


5 


a 


BCD record to be punched. 


binary. 


6 


a 


binary record to be punched. 


binary. 


7 


a 


binary record to be punched. 


BCD. 


K 


a 


BCD mediary record. 


BCD. 


L 


a 


BCD mediary record. 


binary. 


M 


a 


binary mediary record. 


binary. 


N 


a 


binary mediary record. 


BCD. 


O 


a 


BCD record to be ignored. 


BCD. 


P 


a 


BCD record to be ignored. 


binary. 


Q 


a 


binary record to be ignored. 


binary. 


1 « 


a 


binary record to be ignored. 


•CD. 



Figure 6. Type 2 and 3 Data Record Control Characters 

the size of a single data record is limited by the size of 
a single buffer, as data records can never be continued 
from one buffer to another. 



n 


n 


H 


n 


n 


X 



5 6 



11 12 



17 18 23 24 



29 30 



35 



where: 



nnnnn 

is a BCD number (right-justified) that specifies the number 
of characters in the data record, including the six characters in 
the control word itself . 
x 

is one of the control characters listed in Figure 6. 

The control character for each data record, x, should 
be one of the characters shown in Figure 6. 

These codes allow mediary records (that is, records 
that may be required for further processing later in the 
program or may be used as input to another program 
at a later date) to be intermixed with records that are 
to be listed or punched. - 

In processing Type 2 input records, iobs ignores con- 
trol characters. When Type^ records are being written, 
iobs inserts a control character K into the control word 
of bcd data records and a control character M into the 
control word of binary data records. 

Mixed mode files being read from or written on unit 
record devices should be considered to consist of Type 
3 records. The physical record is not blocked* does not 
contain a control word, and must not exceed the maxi- 
mum physical record length of the device. 

Although the length of each Type 2 or Type 3 data 
record is specified in the control word of the record, 



Opening 

Before processing of a file can begin, the file must be 
opened. That is, the file control block must be initial- 
ized, buffers assigned to the file, and the primary input/ 
output unit positioned to the first record of the file. 

The format of the calling sequence used for opening 
a file is: 



TSX 
pfx 



S.OPEN,4 
file„d 



where: 

pfx, 

S bit = if the unit is to be rewound before processing 
begins. 
= 1 if the unit is not to be rewound before processing 
begins. 

1 bit = if the file being opened should be processed in 

BCD mode. 

= 1 if the file being opened should be processed in 
binary mode. 

2 bit = if the file being opened is an input file. 

= 1 if the file being opened is an output file, 
file 

is the location of the first word of the file control block for 
the file being opened (i.e., the name of the file), 
d 

is ignored if the prefix, pfx, specifies that the primary unit is 
to be rewound. If the unit is not to be rewound and the file 
control block specifies that the file is labeled, then d has the 
following significance: . 

d = 0; do not check the header label on the primary unit, 
d = 1; check the header label on the primary unit. 
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When this calling sequence is given, iobs initializes 
the file control block by setting the mode and input/ 
output bits to agree with the calling sequence and 
setting the cumulative fields to zero. If there are not 
enough buffers available to fill- -the -buffering require- 
ments of the file, the job is terminated. 

If the file is labeled and either the calling sequence 
specifies a rewind or the decrement of word 1 of the 
calling sequence is 1, the header label of the file is 
either read into core storage and verified or created 
and written out v depending on whether the file is an 
input or output file. 

If the file control block specifies that a checkpoint 
follows the header label on each reel of the file, this 
checkpoint is taken if the file is output or is skipped 
over if the file is input. If the file control block specifies 
that a checkpoint be placed in the checkpoint file when- 
ever a new reel is begun on the file currently being 
opened, such a checkpoint is taken if there is an open 
checkpoint file. 

If the user wishes to open several files at a time, he 
can use the following calling sequence: 



TSX 
PZE 



S.OPNL,4 
a,t,n 



where: 



a,t *\-y' 

is the location of the first of a series of words like word 1 
of the S. OPEN calling sequence, each defining one of the files 
to be opened and die actions to be taken for that file. 



is the number of files to be opened. 

If one or more files require checkpoints to be taken 
on the checkpoint file, and that file is already open, 
a single checkpoint is taken after all of the files specified 
by the list have been opened. 



If the address of the transmit area, tmtadd, is left 
blank, the data is located in the buffer, but is not trans*- 
mitted. * 



Processing Type 1 Input Records 

When the s.getl calling sequence is given for an input 
Jile consisting of Type 1 records, iobs compares the 
number of data records contained in each block (if this 
is specified in the file control block) with the number 
of data records already provided from the current 
buffer. If it is possible that the current buffer contains 
another data record, the data record lenjgth field in the 
file control block is compared with the number of 
words left in the buffer. If the number of words left 
in the buffer exceeds the record size, the address of the 
first unused data word in the buffer is placed in the 
address portion of word fgcur. If tmtadd is nonzero, 
"the data record is transmitted to the area that begins 
with tmtadd. 

If the number of data records that have been sup- 
plied from the current buffer is equal to the maximum 
number of data records in a block, or if there are not 
enough words remaining in the buffer to satisfy the 
record length requirements in the file control block, 
buffer switching occurs and any data words remaining 
in the buffer are lost. The iobs then attempts to find 
the required number of data words in the next buffer. 
If there are not sufficient words in the new block to 
satisfy the requirements for a data record, the error 
routine specified by the file control bloek is entered ( as 
described in "iobs Error Procedures" at the end of this 
chapter). The job is terminated if no error routine has 
been indicated. 



Input File Processing 

When the programmer wants to be provided with a 
single data record ( as specified in the file control block ) 
from a file, he uses the following calling sequence: 



TSX 
PZE 



S.GETL,4 
file„tmtadd 



where: 

file 

is the address of the first, word of the file control block of the 
file from which the record is to be obtained (i.e., is the name 
of the file, as specified in the FILE pseudo-operation or the 
$FILE card). 

tmtadd 

is the location of The area into which the data record is to 
be transmitted by IOBS. 



Processing Type 2 Input Records 

When requested to get a Type 2 data record, iobs 
assumes that the next data word of the file is the control 
word for the next data record. It uses this word (per- 
forming bcd to binary conversion, if necessary) to de- 
termine the number of words in the record and places 
this information in the address portion of word fclng 
in the file control block. The location of the word imme- 
diately following the control word is placed in word 
fccur. If the length of the record exceeds the number, 
of words remaining in the buffer, the error return is 
taken ( the job is 'terminated if no error return is avail- 
able) . If a change of mode is indicated, the error return 
is taken. If a transmission area has been specified by 
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the calling sequence, the data in the record is moved 
to this area, beginning at location tmtadd. 

Processing Type 3 Input Records 

The major difference between the method of processing 
used by iobs for Type 2 data records and that used for 
type 3 data records is in the handling of control char- 
acters. 

When control is returned to the main program after 
iobs has obtained a Type 3 data record, the six low- 
order bits of the accumulator contain a version of the 
control character that was found in the control word of 
the record. The control character that is left is one of 
the following characters: 2, 4, 6, K, M, O, or Q. The 
change-of-mode indication is considered internal to the 
operations of iobs and is not transmitted to the user. 

Processing Input Files by Blocks 

If the user wants to obtain an entire block (i.e., physical 

record) of data or the remainder of the current block 

of data, he can use the following calling sequence: 

TSX S.GETB,4 

pfx file„tmtadd 

where file and tmtadd are defined in the same way that 
they were for S.GETL, and: 

pfx 

= PZE if the user wants the next complete block of the file. 

— MZE if the user wants the remainder of the current block 
of the file. 

If pfx is pze, iobs begins reading a new block into 
the current buffer, places the location of the first data 
word of the next buffer in the address portion of fccur, 
and places the number of words that were read into 
that buffer in the address portion of word fclng. 

If pfx is mze, the address of the first unused data 
word in the current buffer is placed in fccur, and the 
number of data words remaining in the buffer is placed 
in fclng. If there are no more data words in the current 
buffer, the address portions of both fccur and fclng 
are set to zero. 

If tmtadd is nonzero, the data located by this opera- 
tion is moved from the buffer to the transmission area 
that begins with location tmtadd. 

Non-Data-Transmitting Operations on Input Units 

The iobs allows several non-data-transmitting opera- 
tions to be used with input files. 

Backspace: To backspace over one block, the pro- 
grammer can use the following calling sequence: 

TSX S.BSR,4 

PZE file„bof 

The symbol file is the location of the first word of 
the file control block, and bof is the location of a 
routine to be entered if the unit is already at the 



beginning of the file, where no backspacing can take 
place. 

When this operation is performed, the file is un- 
buffered, the unit assigned to the file is backspaced, 
and the block count, in word fcbsn of the file control 
block, is reduced by one. If the block count is already 
zero, the bof return is taken. The result of a backspace 
operation on a mixed mode file is unpredictable. 

Force End-of-Reel: If the programmer wishes to 
simulate the end-of-reel condition on a file, he can use 
the following calling sequence: 



TSX 
PZE 



S.FEOR.4 
file 



When this calling sequence is used, iobs types any 
deferred mounting message, rewinds and unloads the 
unit from which records were being read, rewinds the 
alternate unit for the file, switches units, and, if the 
file is labeled, checks the header label on the new unit. 
If the file control block indicates that a checkpoint 
appears on the file, this checkpoint and its file mark 
are passed over. If the file control block indicates that 
a checkpoint should be written on the checkpoint file 
when units are switched, this checkpoint is written. 
. Rewind: If the programmer wishes to rewind an 
unlabeled file, he can use the following calling se- 
quence: 



TSX 
PZE 



S.REW,4 
file 



If this calling sequence is given for a labeled file or 
an unopened file, the job is terminated. 

Label Handling 

The iobs uses the Input/Output Label System (iols) 
to perform all label verification and creation pro- 
cedures. If an input file is described as labeled by its 
file control block, the following label operations may 
occur during the processing of the file. 

Header Label: When the file is opened, and each 
time that units are switched, the new header label is 
verified to ensure that the correct reel or unit is being 
used. If the label is in error, it is typed, along with an 
operator message, and a pause occurs. The operator 
may cause the reel to be accepted, mount a new reel 
(to be verified in turn), or terminate the job. 

Trailer Label: When a file mark is read, the end-of- 
reel return is taken. When the erid-of-reel routine re- 
turns control to iobs, the trailer label is read and 
checked. If it indicates the end of the file, the end-of- 
file exit specified in the file control block is taken. If 
the trailer label indicates the end of the reel, the old 
unit is rewound and unloaded, unit switching occurs, 
the new unit is rewound, and the header label on the 
new unit is verified. If the trailer label is in error, it is 
typed, along with an operator message, and a pause 
for operator action occurs. 
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Output File Processing 

When a programmer wishes to place a single data 
record in a file, he has several ways to proceed. If he 
wants to have the record transmitted from a work area 
into the output buffer, or to locate space in an output 
buffer, he can use the following calling sequence: 



TSX 
PZE 



S.PUTL,4 
file„tmtadd 



where: 

file 

is the location of the first word of the file control block. 

tmtadd 

is the location of the first word of the area from which data 
is to be transmitted. 

iobs locates, in an output buffer, the number of words 
specified in the data record length field of the file 
control block. If tmtadd is nonzero, data is transmitted 
from the area beginning with tmtadd into the space 
that has been located. If tmtadd is zero, iobs performs 
no transmission, and it is assumed that the located 
words have been filled by the main program when the 
next reference is made to the file. 

If, on the other hand, the programmer does not know 
the number of words to be placed in the output buffer, 
he can use the following calling sequence to locate 
space in an output buffer: 

TSX S.PLOC,4 

PZE file„n 

where: 

n is the maximum number of words to be used. 

The iobs locates space for n data words in the cur- 
rent buffer, if possible, and places the location of the 
first word available for data in fccur. If space for n 
data words is not available in the current buffer, this 
buffer is truncated and written out, and the location 
of the first available word of the alternate buffer is 
placed in fccur. If there are not n available words in 
me alternate buffer ( presumably empty), the error re- 
turn for the file is taken. If the file control block speci- 
fies Type 2 or Type 3 data records, iobs reserves one 
word, immediately preceding the n words located for 
data, to serve as a control word. 

When the programmer has completed his processing 
and transmission of data into the buffer, he updates 
the file control block by using the following calling 
sequence: 



TSX 
MZE 



S.PUTL,4 
file„m 



The mze prefix indicates that the data is already 
in the buffer, and m is the number of words that were 
actually used of the n that were located. Since the 
buffer displacement field of the file control block is 
not altered until this calling sequence is given, the 



number m may be less than n, without any loss of 
buffer space. If another record is placed in the same 
buffer, it begins immediately after the mth word of 
the previous record. The logical record length specifi- 
cation in the file control block is set to the value of m, 
when the mze prefix is uied. 



Processing Output Data Records 

In summary, if the user wishes to place records in the 
output buffer, he can use one of the following ap- 
proaches: 

1. Type 1 fixed-length data records can be placed 
in an output file by a call to s.putl, with or without 
transmission. 

2. If transmission is desired, the user can specify 
the length of the record by a call to s.ploc, which 
locates the specified number of words. The actual 
number of words to be transmitted is given by the 
logical record length specification in the file control 
block. If desired, the user can change this specification. 

3. If transmission is not desired, the process used 
is the one described in the previous section; i.e., using 
a Call to s.ploc to locate n words and then using a call 
to s.putl (with the prefix of the second word an mze) 
to specify the number of words actually filled. Note 
that the logical record length is updated to m. 

4. The user can place variable-length data records 
in an output buffer by adjusting the data record length 
field in the file control block himself and then calling 
s.putl with or without transmission. 

When a call is made to s.ploc, the address portion 
of fccur is set to the address of the word immediately 
following what will be the control word for the record. 
The control word for a Type 2 or Type 3 record is not 
actually constructed, however, until a call to s.putl is 
made. The length of the record is then calculated, con- 
verted to bcd if necessary, and placed in the control 
word. 

If the file control block for a file of Type 2 records 
specifies that the file is bcd, a control character K is 
placed in bits 30-35 of the control word. If the file is 
binary, the control character is M. 

When the user makes a call to s.putl for a Type 3 
record (or to s.ploc if he is locating space), he must 
leave a control character that specifies the mode of the 
current record (2, 4, 6, K, M, O, and Q) in the six low- 
order bits of the accumulator. If this character indicates 
a mode different from that of the last data record, 
the control character of the first data record in the 
current buffer is changed to indicate that the following 
block is to be read in the opposite mode, the current 
buffer is truncated and written out, and space is located 
for the user's request in the next buffer. 
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Processing Output Files by Blocks 

If the user wants to put a complete block of informa- 
tion into the file, he can use the following calling 
sequence: 



TSX 
PZE 



S.PUTB,4 
file„tmtadd 



When this calling sequence is executed, iobs writes 
out all of the data in the current buffer, sets the buffer 
displacement field in fcnxt to zero, and places the 
starting address and length of the next buffer in the 
address portions of fccur and fclng, respectively. If 
the file is of Type 2 or Type 3 records, no control word 
is created. 

The next time any iobs routine is called for this 
file, the buffer is truncated and written out. If the 
buffer displacement field is still set to the address of 
the first word of the buffer, the entire buffer is written. 
Otherwise, only the data between the beginning of the 
buffer and the address specified by the buffer displace- 
ment field is written. 

If tmtadd is nonzero, a group of words equal in 
number to the specified blocksize of the file is placed 
in the buffer. Not all of these words are necessarily 
written, however, as the buffer displacement field may 
still be changed to exclude some of them. 

If the user wishes to put a variable size block of 
information into the file, he may use the following 
calling sequence: 



TSX 
MZE 



S.PUTB,4 
file„m 



When this calling sequence is executed, iobs trun- 
cates the current buffer and writes out the first m 
words of data in the buffer. The starting address of the 
next buffer is placed in the address portions of fccur 
and fgnxt. The blocksize and logical record length 
specifications in the file control block remain un- 
changed. If the file is of Type 2 or Type 3 records, no 
control word is created. The buffer to be put using 
s. putb with an mze prefix, can be filled either by plac- 
ing data directly into it, or by calling s. putl. 

Non-Data-Transmitting Operations on Output Units 

The iobs allows for several non-data-transmitting oper- 
ations that may be used with output files. 

Backspace: To obtain a backspace over a single 
block, the programmer can use the following calling 
sequence: 

v TSX S.BSR,4 V 

PZE file„bof 

The symbol bof is the location of a routine to be 
transferred to if the block count in the file control 
block is zero. 

When this calling sequence is given, the current 
buffer is truncated and written out, and the unit is 



backspaced over the record just written. The result 
of a backspace operation on a mixed-mode file is un- 
predictable. , 

Force End-of-Reel: If the programmer wishes to 
simulate the end of medium on an output file, he can 
use the following calling sequence: 



TSX 
PZE 



S.FEOR,4 

file 



When this calling sequence is used, the current 
buffer is truncated and written out. A file mark is writ- 
ten, and if the file is labeled, a trailer label indicating 
the end-of-reel condition is created and written, and 
another file mark is written. The unit is then rewound 
and unloaded, and primary and secondary units are 
switched. The secondary unit is rewound. If the system 
is labeled, the retention period of the old header label 
is checked. If the file is labeled, a new header label 
is written, followed by a file mark. If the file control 
block indicates that a checkpoint should be written 
when units are switched (either on the new unit of the 
file or on the checkpoint file), this checkpoint is written. 
The job is terminated if the file is unopened. 

Write File Mark: If the programmer wishes to write 
a file mark on an unlabeled output file, he can use the 
following calling sequence: 



TSX 

PZE 



S.WEF.4 
file 



This calling sequence causes the current buffer to 
be truncated and written out and a file mark to be 
written following it. If an end-of -medium indicator is 
detected while the file mark is being written, the end- 
of-reel exit specified by the file control block is taken. 
If the file specified by this calling sequence is not open, 
is a labeled output file, or is any input file, no operation 
is performed and the job is terminated. 

Rewind: If the programmer wishes to rewind an un- 
labeled file, he can use the following calling sequence: 



TSX 
PZE 



S.REW,4 
file 



This calling sequence causes the current buffer to be 
truncated and written out and the unit to be rewound. 
If the calling sequence is given for an unopened file 
or for a labeled file, no operation is performed and the 
job is terminated. 

Label Handling 

The following operations may occur with output files: 
Header Label: When a labeled or unlabeled output 
file is opened and at the beginning of each new reel 
of the file, if the system is labeled, the retention period 
specified by the header label of the file already on the 
reel is checked. [Labeled systems are described in 
"Output Unit Header Label" under "Input/Output 
Label System (iols)."] If this retention period has 
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expired, the reel is accepted, and if the file is labeled, 
a header label for the new file is created and written. 
If the retention period has not expired, a pause for 
operator intervention occurs. The operator may cause 
the reel to be accepted, mount a reel that has an ex- 
pired retention period (this one is also verified), or 
terminate the job. 

Trailer Label: When the end-of-medium indicator 
is sensed or when a call is made to s.feor, if the file 
is labeled, an end-of-reel trailer label is created and 
written. Units are then switched. An end-of-file trailer 
label is formed and written when the file is closed, if 
the file is labeled. 



The result of closing and re-opening a mixed-mode 
file is unpredictable. 

If it is desired to close several files at a time, the 

following calling sequence can be used: 

TSX S.CLSL,4 

PZE a,t,n 

where: 

a,t 

is the location of the first of a series of words of the same 
form as word 1 of the S.CLSE calling sequence, each defining 
one of the files to be closed and the actions to be taken for 
that file, 
n 

is the number of files to be closed. 



Closing 

When the processing of a file has been completed, 

the file should be closed with the following calling 

sequence: 

TSX S.CLSE,4 

pfx file 

where: 
pfx 

S bit = 0' if the unit is to be rewound. 

= 1 if the unit is not to be rewound. 

1 bit = if the unit is not to be unloaded when it is re- 

wound. 
= 1 if the unit is to be unloaded when it is rewound. 

2 bit = if the end-of -data-file procedure is to be executed. 

= 1 if the end-of -data-file procedure is not to be ex- 
ecuted. 

The end-of -data-file procedure on labeled output files 
consists of creating and writing an end-of-file trailer 
label, preceded and followed by file marks. For an un- 
labeled output file, the end-of -data-file procedure 
consists of writing a file mark. There is no end-of -data- 
file procedure for input files. 

When a file is closed, the following sequence of 
actions occurs: 

1. If the file control block shows that the file was not 
open, only the rewind operations specified in the call- 
ing sequence are performed. Control is then immedi- 
ately returned to the calling program. 

2. If the file is an input file and the mon option is 
specified in the calling sequence, the file is unbuffered 
in closing. That is, the unit to which the file is attached 
is positioned in the correct location to read the block 
following that from which the last logical record re- 
quested by the user was obtained. 

3. If the file is ah output file, the current buffer is 
truncated and written out. 

4. The rewind and end-of -datable options specified 
in the calling sequence are executed. 

5. The buffers are returned to their pool. 

6. The ob (Open Status) bit in the file control block 
is turned off. 



Miscellaneous Considerations 

Nonstandard and Additional Label Processing 

The iobs allows the user to create and verify labels 
different from those usually provided, and still use the 
automatic unit switching and label writing and reading 
facilities. This is done by specifying either nonstandard 
or additional label processing in the file control block. 

If nonstandard label processing is specified for an 
input file> iobs reads each label when a label should 
appear on the unit and then transfers control to the 
nonstandard processing routine specified in the file 
control block. Similarly, when an output file has non- 
standard labels, iobs provides the nonstandard, routine 
with a 20-word buffer in which to create a label and 
then writes the buffer out when control is returned to it. 

If additional label processing is specified, iobs per- 
forms all of the verification and creation that would 
normally be performed and then transfers control to 
the user's routine for the verification or creation of 
extra fields in the 20-character optional Use field of the 
standard label. The user's routine is not entered if an 
error in the label is detected by iobs and the operator 
takes the option of accepting the reel. 

For complete information on this subject, the reader 
should refer to the sections "Format of Labeled Files," 
"Format of Labels," and "Nonstandard and Additional 
Label Processing" in the chapter "Input/Output Label 
Systems (iols)." It is with this part of iocs that the 
user's nonstandard and additional label processing 
routines communicate. 

Unlabeled Files 

The User may specify an unlabeled file as being either 
single-reel or multi-reel. This specification affects the 
action taken by iobs when a file mark is read. 

When a file mark is read on a single-reel unlabeled 
input file, iobs transfers control to the end-of-file 
routine specified in the file control block (described in 
the section "End-of -File Exits*"). 
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When a file mark is read on a multi-reel input file, 
iobs transfers control to the end-of-reel routine speci- 
fied in the file control block. This routine can either 
close the file or return control to iobs. 

In the latter case, automatic reel switching occurs 
and control is returned to the main program. It should 
be noted that the end-of-file exit is never used on an 
unlabeled multi-reel file. It is therefore necessary that 
the user provide his program with some other means of 
detecting the end of the data file. 

The end-of-reel exit is taken whenever an end-of- 
medium indicator is sensed on an output unit, regard- 
less of whether or not the output file is multi-reel. The 
end-of-reel routine can close the file, return control to 
iobs to cause unit switching, or continue to write on the 
unit. The last possibility should be avoided, because 
continued writing may result in job termination if the 
symbolic unit being written on is disk storage or may 
pull the end of the tape off the reel if the symbolic 
unit is a magnetic tape unit. 

Multi-File Reels 

It is possible for a given input/output unit to hold more 
than one file. To process these files, the user simply 
opens the first file, processes it, closes it without a re- 
wind, opens the next file without a rewind, etc. If the 
files are labeled, the closing procedure on each file 
leaves the unit positioned correctly for opening the 
next file (i.e., just before the header label). 

End-of-Reel Exits 

Whenever an end-of-reel trailer label is read, a file 
mark is read on an unlabeled multi-reel input file, or 
the end-of-medium indicator is detected on an output 
unit, the following calling sequence is executed by iobs: 

TSL eorex 

where: 
eorex 

is the location of the user's end-of-reel routine for the file, 
specified in the file control block. 

When this exit is taken, the accumulator contains the 
following information: 

PZE file 

If unit switching is desired, control may be returned 
to iobs by a tra* eorex. 

End-of-File Exits 

When an end-of-file trailer label is read, when a file 
mark is read on a single-reel input file, and when the 
user attempts to get a record or block from an un- 
opened input file, the following instruction is ex- 
ecuted: 

TRA eofex 



where: 

eorex 

is the location of the user's end-of-file routine, specified in 
the file control block. 

When this exit is taken, the accumulator contains the 
following information: 

PZE file 



IOBS Error Procedures 

The iobs allows the user to provide a routine of his own 
for taking corrective action on the following kinds of 
errors: 

ERROR NUMBER CONDITION 

1 Block sequence number errors 

2 Check sum errors 

3 Both block sequence and check sum errors 

4 An unrecoverable read error 

5 An attempt to write on an unopened 
output file 

6 Buffer overflow (an attempt to write a 
data record longer than the buffers at- 
tached to the file) 

7 Reading of a Type 2 or Type 3 record 
in which the control word specifies a 
record length greater than the number 
of words remaining in the buffer, or a 
request to get a Type 1 record longer 
than the buffers attached to the file 

8 Unexpected mode change 

9 An unrecoverable write error 
10 Incomplete word read 

When any one of the above errors is encountered, 
iobs executes the following instruction: 

TSL errex 

where: 

errex 

is the location of the entry point to the user's error-correction 
routine, specified in the file control block. 

The following information is left in the accumulator: 
PZE file„n 

where: 
n is one of the error numbers shown. 

All three index registers have the same contents that 
they had when iobs was entered. 

The error-correction routine can restore all index 
registers and return control to iobs by a tra* errex. 
If this is done, the following actions are taken for the 
various kinds of errors: 

a. If the error was of type 1, 2, 3, 4, 8, 9, or 10, the 
block in error is accepted as valid. 

b. If the error was of type 5, the file control block 
is tested to see if the file is now open. ( The error rou- 
tine can call s.open for the file. ) If the file is open, 



20 



processing continues; if it is not, the job is terminated. 

c. If the error was of type 6, iobs processes as much 
of the block as will fit in the buffer and ignores the rest. 

d. If the error was of type 7, iobs sets the logical 
record length field in fclng to the number of words 
remaining in the buffer. 

The user can accept an error record for error types 1, 
2, 3, 4, 7, 8, or 10 by returning control to iobs by a tba* 
errex and initiating a request for another record when 
iobs returns control to his program. 

The user can ignore input file error returns for error 
types 4 and 10 by continuing with a get request within 
the file rather than returning control to iobs with the 
tra* instruction. If the file contains blocked records, 
ignoring the error condition results in losing all the 
records within the block. 



When iobs encounters one of the following errors, the 
job is terminated: 



ERROR NUMBER 


CONDITION 


11 


Caller returned to IOBS from error num- 
ber 5 without opening the file 


12 


Insufficient buffers to open this file 


13 


No end-of-file exit provided for this file 


14 


An attempt to get or put a record on the 
checkpoint file 


15 


An attempt to put a record on an input 
file 


16 


An attempt to get a record on an output 
file 


17 


An attempt to perform an invalid non-data 
operation 


1$ 

19 


An attempt to write a file mark on an 
input file 

An attemDt tO Switch rf*»ls rin a cinrrlo-vool 



output file 
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input/Output Operations (IOOP) 



Some applications involve data processing methods 
that do not require the facilities of iobs or that cannot 
be implemented using iobs. For this reason, the struc- 
ture of iocs has been designed to allow the program- 
mer to use the Input/Output Operations level of iocs 
directly. 

Input/Output Operations (ioop) performs the read- 
ing and writing operations of iocs. It contains facilities 
for reading and writing physical records and perform- 
ing non-data-transmitting operations with the devices 
supported. It also provides an automatic response to 
real-time-device input, e.g., teleprocessing and tele- 
graph messages, and includes a buffer-chain manipula- 
tion facility for input on these devices. 

A synchronization routine, a calling sequence inter- 
pretation routine, and a select and error-recovery rou- 
tine for each device are Contained in ioop. The 
synchronizer coordinates the initiation and completion 
of input/output operations with the execution of the 
user's program. It allows four different modes of syn- 
chronization to be used. 

The calling sequence interpreter accepts requests 
made by the main program for input/output opera- 
tions. Because requests for operations are recorded in 
the system control block that corresponds to the sym- 
bolic unit being used, requests cannot be stacked by 

IOOP. 

The select and error-recovery routine for each device 
translates the request for an operation made by the 
user's program into the 7040 input/output instructions 
necessary to perform the operation on the unit speci- 
fied. If there is an error when the operation is per- 
formed, the select and error-recovery routine initiates 
measures to correct (i.e., recover) the error. 

A special form of the call to ioop for telecommunica- 
tions input causes the device to be "opened." This call 
establishes linkages to the' system control block, unit 
control block, buffer chains, and special routine. Data 
transmission takes place only if an attention trap oc- 
curred prior to this call. Once the device is opened the 
attention traps initiate the steps by which the messages 
are read and placed in a buffer chain. Devices that 
have been "opened" may also be "closed," e.g., when 
all messages have been processed and no more are ex- 
pected. 

Telecommunications output units are treated the 
same as unit-record equipment, To initiate output for 
teleprocessing devices or telegraph units, the user must 



make a call to ioop for each message to be written. A 
synchronized call for an output operation will wait for 
the attention that signals the completion of message 
transmission. When required by a device, the formats 
and special character codes must be furnished by the 



user. 



Use of IOOP 

The use of the ioop level of iocs requires the following 
actions on the part of the programmer: 

1. He must reserve the buffers necessary for his ap- 
plication. 

2. He must write into his program any coding neces- 
sary for buffer supervision or for blocking and de- 
blocking data records. For telecommunications input 
devices, he must write a special routine that contains 
any coding necessary to locate the message in a "filled 
buffer chain," unlink the buffer, process the message, 
and return the empty buffer to an "available buffer 
chain." He must also provide error procedures within 
the special routine, since the normal error return is 
never taken by ioop for data-transmission errors on 
these devices. 

3. In the parts of his program that require the 
reading or writing of records or some non-data-trans- 
mitting operation on an input/output unit, he must 
use a calling sequence to ioop. This calling sequence 
specifies the operation to be performed, the symbolic 
unit to be used, and the method of synchronization 
required. He may also specify the location and priority 
of a special routine to be executed as soon as the opera- 
tion has been completed. For telecommunications input 
devices, he must provide a calling sequence to "open" 
each device. This calling sequence supplies the location 
of control words for both the "available buffer chain" 
and the "filled buffer chain." It specifies the symbolic 
unit to be used, and the entry point and priority of a 
special routine (required for these devices). 

Buffers 

When reserving space for buffers into which records 
will be read and from which records will be written 
by ioop, the user should reserve an area equal in 
length to the size of the largest possible physical 
record, plus two. One extra word, at the beginning of 
the buffer, is used by ioop as a buffer control word. 
When a request for a read or write operation is made, 
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the parameter given to ioop should specify the location 
of the first data word to be read or written, i.e., the 
word immediately following the buffer control word. 
Each input buffer should also have an extra word at the 
end, to allow for the possibility of a device error. When 
a request has been made to ioop to have a record 
read into or written from a given buffer, no reference 
can be made to the buffer or to any word in it until 
ihe operation has been completed and checked. 

ioop contains, in the select routines for real-time in- 
put devices, an automatic buffering function that per- 
mits immediate response to teleprocessing device or 
telegraph unit attentions. Empty buffers are linked in 
an available buffer chain. When an input attention trap 
occurs, ioop unlinks a buffer from the available chain, 
causes a message to be read into it, and links it to a 
filled buffer chain, ioop also provides a routine that 
can be called by the user to locate the message in the 
filled chain, unlink the buffer, and return the empty 
buffer, after processing, to the available chain. ( See 
"Buffer Chain Manipulation Routine/') The user must 
provide the routine that processes the message. 

Symbolic Units Table 

When the Nucleus is assembled, one word of core 
storage is reserved for each symbolic uni* defined. 
These words form the Symbolic Units Table. The table 
is used to record the correspondence between symbolic 
units and physical devices, and the status of each unit. 
When a symbolic unit has been attached to a physical 
device, the format of the Symbolic Units Table entry is: 
S.Sxxx 



°s° 



1( scb > 



000 



l(ucb) 
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S 2 3 17 18 20 21 

where: 

S.Sxxx 

is the name of the symbolic unit. 
RS 

= if this unit is not in use by an object program. 

= 1 if this unit is in use by an object program. 
1 (scb) 

is the location of the system control block for this symbolic 
unit. 

1 (ucb) 

is the location of the unit control block for the input/output 
device to which this symbolic unit is attached. 

The name of the symbolic unit is the symbol for the 
location of this entry in the Symbolic Units Table, and 
is recognized as such by the Macro Assembly Program 
(ibmap). System control blocks are discussed later in 
this chapter. Unit control blocks are used to record in- 
formation concerning the various input/output devices 
attached to the 7040/7044, and each one contains the 
machine address of the physical device to which it cor- 



responds. Unit control blocks are discussed in the chap- 
ter "Input/Output Executor (ioex)." 

System Control Blocks 

In addition to the Symbolic Units Table, ioop requires 
a system control block for each symbolic unit. For 1402, 
1403, 1622, 729, and 7330 devices, the system control 
block is four words long. For 1009, 1011, 1014, and tele- 
graph devices, attached through a 1414, Model IV or V, 
Input/Output Synchronizer, the system control block 
is four words long. For a symbolic unit that consists 
of a section of 1301 Disk Storage or 7320 Drum Storage, 
the system control block is eight words long. The last 
four words apply only to devices requiring an order. 

The format of the system control block is shown in 
Figure 7. 

The possible types of system control blocks, as spec- 
ified in field scrap, are: 

00 Not specified 

01 Printer on channel A ( 1403 ) 

02 Card punch on channel A (1402) 

03 Card reader on channel A ( 1402 ) 

04 Magnetic tape unit on channels A-E 

05 Paper tape reader on channel A ( 1011 ) 

06 Card punch on channel A ( 1622 ) 

07 Card reader on channel A (1622) 

10 Not specified 

1 1 Printer on channel S ( the on-line 140 1 ) 

12 Card punch on channel S 

13 Card reader on channel S 

14 Magnetic tape unit on channel S 
15-17 Not specified 

20 Disk or drum storage, accessed randomly 

21 Disk or drum storage, accessed sequentially in single- 
record fashion 

22 Disk or drum storage, accessed sequentially in full- 
track with addresses mode 

23 Disk storage, accessed sequentially in cylinder mode 

24 Drum storage, accessed sequentially in cylinder 
mode 

25-40 Not specified 

41 Data transmission unit on channel A, output ( 1009) 

42 Remote inquiry unit on channel A, output ( 1014 ) 

43 Telegraph unit on channel A, output ( TTY) 

44 Not specified 

45 Data transmission unit on channel A, input ( 1009 ) 

46 Remote inquiry unit on channel A, input ( 1014 ) 

47 Telegraph unit on channel A, input ( TTY ) 
50-77 Not specified 

The possible contents of the reserve status field, 
scres, are as follows: 

00 Unreserved and not in use 

01-62 Intersystem reservation requested by the object 
program 

63-67 Not specified 

70 Unreserved and in use by the object program 

71 Unreserved and in use by a priority program 
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1. SCSIZ 
SCTYP 
SCRES 



2. SCOPR 



3. SCIOC 



4. SCSNS 



5. SCUM 



6. SCPOS 



7. SCDOl 



8. SCD02 



S 1 2 3 4 5 



Length of 
this system 
control block 



6 7 8 9 10 11 



Type of this 
system control 
block 



12 13 14 15 16 17 



Reserve status 
of this symbolic 
unit 



Operation currently requested for this unit 




21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 



Location of the word in the Symbolic Units 
Table that points to this system control 
block 



Location of the standard select and error-recovery 
routine for this unit 



The Input/output channel command is placed in this word when the operation is requested,* and the 
store channel and error information is left in this word when a file mark is read.** 



'" of recs 
per 

track (1st 
3 bits) 



Sense status information for devices 
requiring an order ** 



Track number of the first track 
assigned to this symbolic unit 




Track address of next record if cylinder mode, 
otherwise record number of last file mark** 



Disk order * 



Current 
record 
number ** 




Location of the entry point to the special 
processing routine specified for this 
operation * 



Track number of the last track assigned 
to this symbolic unit 



Verification address of this record * 



* Inserted by the IOOP unit synchronizer. 
** Inserted by the IOOP select and error-recovery routine. 

The meanings of the two-character codes are: 

EM - End-of-Medium Indicator 

= if no end-of-medium indicator has been detected. 
= 1 if an end-of-medium indicator has been detected. 

BM - Beginning-of-Medium Indicator 

= if the device is not positioned at the beginning of the 

medium . 

= 1 if the device is positioned at the beginning of the medium. 

PR— Priority Indicator 

is the priority of the special routine whose entry point ad- 
dress is held in the address portion of word SCRTN. 

Figure 7. Format of the System Control Block 



Track number of the last file mark 
Written on the unit ** 



Current track number * 



SCUNl 



SCSEL 



SCSCH 



SCRTN 



SR - Split Record 

= current record is not split. 

= 1 current record is split between cylinders. 

WC -Write Check Indicator 

- if no write check is to be performed. 
= 1 if a write check is required. 

NR - No Record Found Bit. 

= if the standard procedure is to be performed for a no- 
record^fdund coriditiori. •■ 

= 1 if the special procedure is to be performed for a no- 
record-found condition. 



72 Unreserved and in use by a permanent program 

73 In use as a S.SLBx unit 

74 In use as a S.SINx unit 

75 In use as a S.SOUx unit 

76 In use as a S.SPPx unit 

77 In use as a S.SCK1 unit 

The octal codes marked as not specified are reserved 
for future ds Programming Systems use. 

Object programs must respect the reservation status 
of symbolic units. The reservation status of the unit is 
not checked by ioop when an operation is requested. 

The system control block is used by ioop to retain 
information about each opeartion requested on the 



symbolic unit. The calling sequence interpreter pro- 
vides the initial entries in the various fields, but the 
information is used and updated by the select and 
error-recovery routines. Any synchronizer for the ioex 
level that uses the standard select and error-recovery 
routines of ioop must perform this initialization 
function. 



IOOP Calling Sequence 

Only one entry point is used by ioop. The parameters 
| of the calling sequence describe the operation, the unit, 
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and the input/output area to be used. One generalized 
calling sequence is used for all data-transmission re- 
quests. A slightly modified form of this calling se- 
quence, described separately, is used for the "opening" 
and "closing" of a telecommunications input device. 
The format of the calling sequence to ioqp for data- 
transmission is: 



TSX 
oper 
pfxl 
pfx2 



S.IOOP.4 
ioparm.tl 
S.Sxxx,t2 
erret,t3,sprtn 



where: 

oper 

is an operation code describing the operation to be per- 
formed (e.g., read or write) and the method of synchroniza- 
tion to be used. The assembled form of this operation code 
extends into the decrement portion of the word. 
ioparm,tl 

is the location of a word of the following form: 



000 



count 



S 2 3 



000 



first word 



17 18 20 21 



35 



where: 
count 

is the number of words to be read or written. If count 
is zero, this has the same effect as IODLY, and sprtn is 
ignored, 
first word 

is the location of the first word of the buffer into which 
data is to be read or from which data is to be written, 
pfxl 

= PZE if this word is the last one in the calling sequence 
(if no error return or special routine is specified). 

= MZE if this word is not the last one in the calling 
sequence. 

S.Sxxx,t2 

is the location of a word specifying a system control block 
and a unit control block. This word may be a Symbolic Units 
Table entry, or it may be a word constructed by the pro- 
grammer. 

pfx2 

= PZE, PON, PTW, PTH, or MZE if the entry point of a 
special routine of priority 0, 1, 2, 3, or 4 is specified in the 
decrement portion of this word. 
erret,t3 

is the location of the entry point to an error routine. The 
error routine is entered if an error occurs during the operation 
synchronized by this calling sequence. If an error occurs during 
the operation and no error return has been specified, the job 
is terminated. The use of the error return is discussed in 
"Status Information." 
sprtn 

is the location of the entry point to a special processing 
routine that is to be entered when the operation initiated by 
this calling sequence has been completed. Special processing 
routines are discussed in "Special Routines." 

Index registers 1, 2, and 4 are saved when this calling 
sequence is executed, and they are restored before con- 
trol is returned to the calling program. Locations s.ssch 
and s.ssns are set for the operation synchronized by 
this calling sequence. Multiple tagging is allowed in 
the tag fields of the calling sequence, but it should be 
remembered that multiple tags result in adding to the 



specified address the 2s complement of the logical or 
of the contents of the index registers used. 

The format of the calling sequence to open a tele- 
communications input device is: ' 



TSX 
IOTPI 
MZE 
pfx2 



S.IOOP,4 
ioparm,tl 
S.Sxxx,t2 
erret,t3,sprtn 



where: 

ioparm.tl 

is the location of a word of the following form: 



000 



fchain 



2 3 



000 



achain 



17 18 20 21 



35 



S 

where: 

achain 

is the address of the control word ( BPCHN ) for a chain 
of available buffers (see "Assembling Buffer Chains"), 
fchain 

is the address of the control word ( BPCHN ) for a chain 
of filled buffers. 

The other parameters of this calling sequence are 
the same as the corresponding ones for data transmis- 
sion. The parameter sprtn is required. The normal error 
return is taken for program errors only. 

The format of the calling sequence to close a tele- 
communications input device is identical to that for 
opening the device, except that ioparm,tl is the loca- 
tion of a word of the form: 

PZE o„-l 

A call to ioop to open a teleprocessing or telegraph 
input device should not be made if the device has al- 
ready been opened. A device should not be closed 
until the special routine has processed all messages, 
and no further messages are expected. 

A method has been provided to allow indirect ad- 
dressing of the words of the ioop calling sequence. 
To address a given word of the calling sequence indi- 
rectly, the programmer uses an ioop calling sequence 
in which the indirectly addressed word is replaced with 
a word of the following form: 



pfx 



loc,t,-l 



where: 
loc,t 

is the location of the word that is actually to be used in this 
position in the calling sequence. 
-1 

(assembles as an octal 77777) indicates that the word is 
indirectly addressed. 

Indirect addressing can extend to any depth. The 
only part of the ioop calling sequence that cannot be 
indirectly addressed in this manner is pfxl, which must 
appear in its normal position in the calling sequence. 
An example of the use of indirect addressing to write 
the same record on two different output units is shown 
in Figure 8. 
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TSX 


S.IOOP,4 


PARM4 


PZE 


PARM1„-1 




PZE 


PARM2„-1 




TSX 


S.IOOP,4 




PZE 


PARM4„-1 




PZE 


PARM3„-1 


PARM1 


lOWDS 


IOCOM 


PARM2 


PZE 


S.SU01 


PARM3 


PZE 


* + l„-l 




PZE 


S.SU02 


IOCOM 


PZE 


FWORD„6 




PZE' 


** 


FWORD 


BCI 


6JHIS IS INDIRECT ADDRESSING 



$WRITE RECORD ON UNIT 1 



$WRITE RECORD ON UNIT 2 



BUFFER CONTROL WORD 



Figure 8. Example of the Use of ioop 



Synchronization Types 

In using ioop, the programmer may specify one of the 
following four types of synchronization: 

Priority 

Synchronize 

Initiate 

Return Immediate 

The method of synchronization chosen determines 
the point in the progress of the operation at which 
control is returned to the calling program and also 
affects the treatment of error returns and special proc- 
essing routines. 

ioop does not allow for synchronization of tele- 
processing or telegraph input devices. AH input activity 
on these devices occurs as a result of an externally 
initiated attention, and not as the direct result of a 
call to ioop. 

PRIORITY REQUEST 

When the calling sequence to ioop indicates that 
Priority synchronization is required, the following se- 
quence of actions is performed: 

1. If an operation is already in progress on the speci- 
fied unit, ioop waits until that operation has been 
completed and checked, and until any necessary special 
processing routine has been executed. Such a previous 
incomplete operation is probably the result Of a logical 
error, because, if an error return is necessary, the error 
return specified by this calling sequence (i.e, for the 
Priority operation) is used and the Priority operation 
is neither recorded nor initiated. No distinction is made 
in the error return between an error caused by the 
previous operation and one caused by the Priority 
operation. 



2. The request for the new operation is recorded and 
a request is made to ioex for a Priority operation on the 
channel. 

3. The ioop waits for the completion of the opera- 
tion and the execution of any special processing rou- 
tine that may be required. 

4. If an error return is required, control is trans- 
ferred to the error routine specified in the calling 
sequence for this operation. 

5. If the error return is not required, control is re- 
turned to the calling program. 

The operations that use Priority synchronization are: 

IORBP Read binary data with priority. 

IORDP Read BCD data with priority. 

IOWBP Write binary data with priority. 

IOWDP Write BCD data with priority. 



SYNCHRONIZE REQUEST 

When the calling sequence indicates that the Syn- 
chronize method of synchronization is to be used, the 
following sequence of actions is performed: 

1. If an operation is already in progress on the 
specified unit, ioop waits until that operation has been 
completed and checked, and until any necessary special 
processing routine has been executed. Such a previous 
incomplete operation is probably the result of a logical 
error, because, as was the case in Priority operations, 
the error retum for this calling sequence is used if 
an error was found in the previous operation and the 
new operation is neither recorded nor mitiated. 

2. The request for the new operation is recorded and 
a request is made to ioex for an operation on the 
channel. 
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3. The ioop waits for the completion of the opera- 
tion and for the execution of any special processing 
routine that may be required. 

4. If an error return is required, control is transferred 
to the error routine specified in the calling sequence 
for this operation. 

5. If the error return is not required, control is 
returned to the calling program. 

The operations that use the Synchronize method of 
synchronization are: 

IORBS Read binary data and synchronize. 

IORDS Read BCD data and synchronize. 

IOWBS Write binary data and synchronize. 

IOWDS Write BCD data and synchronize. 

The only difference between Priority and Synchro- 
nize requests for a unit is that the Priority request 
results in a request to ioex for priority use of the 
channel to which the unit is attached. 

INITIATE REQUEST 

When the calling sequence indicates that the Initiate 
method of synchronization is used, the following se- 
quence of actions is performed: 

1. If an operation is already in progress on the 
specified unit, ioop waits until that operation has been 
completed and checked and until any necessary special 
processing routine has been executed. If an error re- 
turn is necessary, the error return specified by this 
calling sequence is used and the new operation is 
neither recorded nor initiated. 

2. The request for the new operation is recorded and 
a request is made to ioex for an operation on the 
channel. 

3. Control is returned to the calling program. 
The operations that use Initiate synchronization are: 

IORBI Read binary data and initiate. 

IORDI Read BCD data and initiate. 

IOWBI Write binary data and initiate. 

IOWDI Write BCD data and initiate. 

RETURN IMMEDIATE REQUEST 

When the calling sequence indicates that the Return 
Immediate method of synchronization is to be used, 
the following sequence of actions is performed: 

1. If an operation is already in progress on the speci- 
fied unit the sign of the word specified by ioparm, tl 
in the calling sequence is set to minus and control is 
returned to the calling program. 

2. If no operation is in progress, but a previously 
completed operation requires an error return, the error 
return specified by this calling sequence is used and 
the new operation is neither initiated nor recorded. 

3. If the unit is not busy and no error return is re- 
quired by a previous operation, the request for the new 



operation is recorded and a request is made to ioex 
for an operation on the channel. 

4. Control is returned to the calling program. 

The operations that use Return Immediate synchro- 
nization are: 

IORBR Read binary data or return immediate. 

IORDR Read BCD data or return immediate. 

IOWBR Write binary data or return immediate. 

IOWDR Write BCD data or return immediate. 
The only difference between Initiate and Return 
Immediate requests for a unit that ioop does not 
wait for a unit to become free when a request is for 
Return Immediate. The user must check any Return 
Immediate request to see if it has been accepted, and 
if not, he must repeat the request. 

Special Routines 

When a calling sequence to ioop requests an operation 
and the execution of a special routine, the location and 
priority of this routine are stored in the system control 
block. When the ioop select and error-recovery routine 
for the device being used finds that the operation has 
been completed, it requests the execution of the special 
routine by placing its address and priority in the unit 
control block. After another input/output operation 
has been initiated on the channel, if possible, <ioex 
looks for the higest priority routine waiting to be ex- 
ecuted, places pze l(ucb) in the accumulator, and 
enters the special routine by a tsx sprtn,4. 

Because the special routine is entered before any 
error routine, it is possible for the special routine to 
be entered for an operation that resulted in a perma- 
nent error. The special routine should examine the 
results of the operation, in words scsgh and scsns of 
the system control clock, to determine whether or not 
an error has occurred. If the special routine stores 
pze o„i into word scsch, no error return will be taken. 

Trapping is not inhibited during the execution of a 
special routine, but all registers are saved when any 
program is trapped. If a special routine of higher 
priority than the one in progresses requested during 
trap-time, this routine is executed before the inter- 
rupted routine is re-entered. Otherwise, the registers 
are restored and the interrupted routine is re-entered 
as soon as the treatment of the trap is complete. 

A special routine may have any priority from zero 
to four, as indicated by the prefix of the last word of the 
calling sequence to ioop that requests it. The main 
program has no priority. 

Buffer Chains 

In order that teleprocessing or telegraph messages can 
be accepted promptly when an attention trap occurs, 
two buffer chains must be provided for each tele- 
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communciations input device. The select routine for 
these devices unlinks a buffer from the available buffer 
chain, and the message is read into the buffer. The 
location of the buffer is inserted in field scopr of the 
system control block. The select routine. then places 
the status information for the device into the buffer 
flag word (bpflg) preceding the now-filled buffer 
(field scsch of the system control block is not used) and 
links the buffer to the filled buffer chain. The select 
routine then requests scheduling of the special routine, 
and an mze is placed in field scopr of the system con- 
trol block. 

If another attention trap occurs before the special 
routine has been completed, the select routine unlinks 
another buffer from the available buffer chain, causes 
it to be read into, links it to the filled buffer chain, and 
returns control to the special routine. Thus, a special 
routine may find more than one buffer in the filled 
buffer chain. If multiple interrupts of the special 
routine have occurred, the routine will be re-entered 
because of a request posted for it by the last atten- 
tion trap, and it will find that the filled chain may have 
already been emptied. 

While each teleprocessing or telegraph input device 
must have an available buffer chain and a filled buffer 
chain, these need not be unique for each device. A 
special routine may in fact return a buffer to an avail- 
able chain other than the one from which it came. It is 
the responsibility of the user's special routine to ensure 
that each device's available buffer chain is replenished, 
and that sufficient buffers are available for the maxi- 
mum number of anticipated messages before the chain 
can be replenished. 

If the select plus routine finds that a buffer is not 
available, the sign of the buffer-length word (bplgn) 
of the available chain control-word pair is set to minus. 
The routine then transfers to ioex with a 2, 4 return, 
requesting rescheduling. If the available buffer chain 
is not replenished in time, one or more messages may 
be lost. 

The pointers to the two chains appear in word scioc 
of the system control block. This word may be as- 
sembled with the following: 



An available buffer chain may be assembled as: 



PZE 



ASSEMBLING BUFFER CHAINS 



achain„fchain 



The buffer-chain control words, the associated buffer 
chains, and their buffers must be assembled such that 
they will occupy a portion of core storage that can 
never be overlaid by, a background program. A buffer- 
chain control-word pair for an available chain may be 
assembled as: 



NEXT1 

NEXT2 
NEXTn 

BUFFI 

BUFF2 

BUFFn 
where: 
lgn 



PZE BUFF1„NEXT2 (BPCON) 

PZE BUFF2„NEXTn (BPCON) 

PZE BUFFn„ACHAIN (BPCON) 

BSS 1 (BPFLG) 

BSS lgn 

BSS 1 (BPFLG) 

BSS lgn 

BSS 1 (BPFLG) 

BSS lgn 



defines the length of the buffer. 

No buffers need be provided for the filled chain. A 

buffer-chain control-word pair for an empty chain may 

be assembled as: 

FCHAIN MZE FCHAIN„FCHAIN ( BPCHN ) 

MZE „lgn (BPLGN) 

BUFFER-CHAIN MANIPULATION ROUTINE 

A routine (s.tpbf) is provided at the ioop level to 
locate a message in a buffer chain and remove the 
buffer from the chain, and to return the buffer to a 
chain. Following are explanations for the use of these 
two functions: 

(J) To locate a message and remove the buffer from 
a chain, the user must first place the following in the 
ac: 

PZE PCHAIN 

where: 

PCHAIN 

is the control word of the buffer chain from which the first 
buffer will be removed. 

The format of the calling sequence to the routine is: 

TSX S.TPBF,4 

Upon return, the ac contains: 

PZE „NEXTi 

where: 

NEXTi 

is the location of the first buffer control word in PCHAIN 
(if NEXTi=0, there is no buffer in PCHAIN). 

The mq contains: 



PZE 



BUFFUgn 



where: 



ACHAIN 



MZE 
PZE 



NEXTn„NEXTl 
„lgn 



(BPCHN) 
(BPLGN) 



BUFFi 

is the location of the first buffer. 

lgn 

is the length of the buffer. 

Before processing the buffer, the user should save 
the contents of the ac returned by the routine. This 
information is placed in the mq when the buffer is 
returned to a chain. 

(2) To return the buffer specified by NEXTi to a buffer 
chain, the user must place the following in the ac: 
MZE „QCHAIN 
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where: 

QCHAIN 

is the control word of the buffer chain to which a buffer will 
be returned. 

The mq must contain: 

PZE „NEXTi 

The format of the calling sequence to the routine is: 

TSX S.TPBF,4 

While the s.tpbf routine is provided, its use is not 
required. If it is not used, the buffer chains should be 
manipulated as follows: 

Assuming there is a buffer in the filled chain, the 
buffer chains should be presented to the user's special 
routine as: 

FCHAIN MZE NEXT1„NEXT1 

PZE „LGN 

ACHAIN MZE NEXTN„NEXT2 

'" PZE „LGN 

NEXT1 PZE BUFF1„FCHAIN 

NEXT2 PZE BUFF2„NEXTN 

NEXTN PZE BUFFN„ACHAIN 

The special routine detaches the buffer from its 
chain leaving: 

FCHAIN MZE FCHAIN„FCHAIN 

MZE „LGN 

ACHAIN MZE NEXTN„NEXT2 

PZE „LGN 

NEXT1 PZE BUFFI,,** 

NEXT2 PZE BUFF2„NEXTN 

NEXTN PZE BUFFN„ACHAIN 

When the special routine finishes processing, the 
buffer is attached to the other chain as : 

FCHAIN MZE FCHAIN„FCHAIN 

MZE „LGN 

ACHAIN MZE NEXT1„NEXT2 

PZE „LGN 

NEXT1 PZE BUFF1„ACHAIN 

NEXT2 PZE BUFF2„NEXTN 

NEXTN PZE BUFFN„NEXT1 



Status Information 

Two fixed locations s.ssch and s.ssns, are used by ioop 
to hold information about the status of all operations 
with one exception— status information about telecom- 
munications input operations is stored in the buffer 
flag word, bpflg. When an operation is synchronized, 
information regarding conditions that occurred during 
the operation is stored in s.ssch and s.ssns. The address 
portion of s.ssch contains the location of the last word 
of data transmitted, plus one, or is zero if data has not 
been transmitted. Bits are set in the prefix and decre- 
ment of s.ssch for the following conditions: 

S The record was successfully read in the opposite mode 

(BCD /binary) from that specified for the operation. 

5 The calling sequence requested the transmission of 

, one Or two words (729/7330 Magnetic Tape Units 

only). 



6 No record found ( for 1301 and 7320 only ) . 
Addressed station inoperative (1014 output only). 
Excessive delay or invalid format (telegraph output 
only). 

7 End-of-medium indicator was detected while writing. 
9 Program error occurred. 

10 External device error was encountered. 

11 External device error was encountered and ignored. 

12 Unusual end occurred (incomplete word was trans- 
mitted if the device was a 729/7330 Magnetic Tape 
Unit). 

13 Recovered error. 

14 Channel parity. 

16 Permanent error. 

17 The operation was completed. ( For 1009 output, this 
bit is set only if the end-of -message indicator is re- 
ceived for the request. ) 

Conditions 5, 6, 7, 9, 10, 12, 14, and 16 cause 
error returns. 

The information found in location s.ssns is described 
separately for each device requiring an order. 

If the end of the medium was detected during a 
write operation, bit 7 is set and the error return is 
taken. Until the unit is rewound or unloaded, bit 7 is 
set on for each subsequent operation on the unit, but 
the error return is not taken. 

If a file mark is read, s.ssch is set to zero and the 
normal return is taken. If a special routine is inspecting 
word scsch of the system control block, it will find 
the information usually found in s.ssch, and bit 15 
indicates the reading of the file mark. 

Program error returns are given when the following 
conditions occur: 

1. If the user requests a read operation that would 
violate storage protection. 

2. If ioop receives a read or write request for a unit 
that is busy from a nonstandard select and error- 
recovery routine. 

3. If a file mark is read while spacing forward by 
records (see "Non-Data-Transmitting Operations" 
under "729/7330 Magnetic Tape Units" ) . 

4. If a request is made to backspace on a unit that 
is already at load point. 

5. If a request is made for an undefined operation, 
e.g., writing binary information on a 1622, reading 
from a 1403, writing a file mark on a random access 
device, or backspacing a unit record device. 

6. If the user attempts to exceed the storage capacity 
of a symbolic unit (e.g., writing past the end of a 
sequentially accessed section" of 1301 Disk Storage, 
as delimited by the system control block for the sym- 
bolic unit). 

7. If the system unit field is zero. \ 

8. If any request other than open or close is made 
for a telecommunications input device or if a request 
is made to open a device that has already been opened. 
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Programmer errors 1, 2, 7, and 8 prevent entry into 
a special routine. 

Status information defining the results of teleprocess- 
ing and telegraph input operations is presented to the 
user in the input buffer, and must be examined in the 
special routine. Since input operations are externally 
initiated, i.e., not as the result of a call to ioop, no 
error return is taken. The input status information is 
stored in the decrement of the buffer flag word, bpflg, 
which precedes the input buffer (see "Assembling 
Buffer Chains"). These bits are defined as: 



BIT 
10 

14 
15 
16 
17 
21-35 



DESCRIPTION 

Transmission error 

Word parity error 

All or part of message lost 

Channel check 

End of message (1009) 

Location of the System Units Table 



ioop makes one exception for these input devices. If 
any call other than open or close is made for tele- 
processing or telegraph input devices or if an attempt 
is made to open an already opened device, ioop sets 
the program error bit in s.ssch and takes the standard 
error exit without scheduling the request. 

Non-Data-Transmitting Operations 

Aside from its reading and writing facilities, ioop pro- 
vides four generalized non-data-transmitting opera- 
tions. These are: 

IODLY 

This operation delays processing until any previously re- 
quested operation on the specified unit has been completed 
and checked. 
IOWEF 

This operation causes IOOP to write a file mark (or to per- 
form some analogous operation) on the specified unit. Initiate 
synchronization is used. 

IOSKP 

This operation causes IOOP to space forward or backward 
on the specified unit. Initiate synchronization is used. 
IODER 

This operation causes the typing of an error message and 
allows the termination of the job, if required. 

UNIT DELAY 

The following calling sequence may be used to delay 
processing until the end of an operation: 

TSX S.IOOP,4 
IODLY 

pfxl S.Sxxx,t2 

pfx2 erret,t3 

All of the elements of this calling sequence are 
defined as they were for data transmission. If an error 
occurs in the operation for which the delay has been 
requested, the error return specified by this calling 
sequence is used. 

Although the program requesting the delay is sus- 
pended until the operation is complete, previously 
requested special routines of a higher priority are still 



executed when the corresponding operations have been 
completed and store channel data for these operations 
has been obtained. Galls from these special routines 
for input/output operations are accepted by ioop. 



WRITE FILE MARK 

The following calling sequence may be used to write a 
file mark on the specified unit: 

TSX S.IOOP,4 

IOWEF 

pfxl S.Sxxx,t2 

pfx2 erret,t3,sprtn 

All of the elements of this calling sequence are 
defined as they were for data transmission. Since 
iowef is an Initiate operation, the error return speci- 
fied by this calling sequence is taken if an error has 
occurred in a preceding Initiate or Return Immediate 
operation. 

The actions taken by ioop, if this operation is re- 
quested on a unit other than a magnetic tape unit, are 
specified in the section "Input/Output Devices." 



repositioning 

The following calling sequence may be used to re- 
position the specified unit: 



TSX 


S.IOOP,4 


IOSKP 


ctlwd.tl 


pfxl 


S.Sxxx,t2 


pfx2 


erret,t3,sprtn 



All of the elements of this calling sequence are de- 
fined as they were for data transmission, except that 
ioparm, tl has been replaced by ctlivd, tl. The address 
ctlwd, tl is the location of a word of the following form: 



pfx 



r„f 



where: 

pfx 

= PZE if the repositioning is forward. 

= MZE if the repositioning is backward. 

= PON if the repositioning is to the location of a specific 
record in the current file. 

If the prefix is pze (forward spacing), r is the num- 
ber of physical records to be spaced over and / is the 
number of files to be spaced over. Each file mark read 
is counted as a file. The / files are spaced first, and then 
r records. 

If the prefix is mze (backward spacing), either r 
or / must be zero. If r is norizero, the unit is back- 
spaced r records ( even if r is greater than the current 
record count). If / equals 1, the unit is backspaced 
until the record count has been reduced to zero. 

If the prefix is pon, / should be zero. The unit is 
backspaced or forward spaced until it is in position 
to read (or write) record r + 1. 
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If / is — 1, the unit is rewound. If the prefix is pze, 
rewinding alone is accomplished. If the prefix is mze, 
the unit is rewound and unloaded. 

If the control word is pze or mze o„0; ioskp has the 
same effect as an iodly and sprtn is ignored. 

device error call 

If an input/output error that was not detected by ioop 
is detected by the user's program ( e.g., incorrect word 
count, incorrect internal label, or nonagreement of 
check sums), the following calling sequence may be 
used to indicate this fact: 

TSX S.IOOP,4 

IODER ercode,tl 

pfx S.Sxxx,t2,messag 

PZE NOT SIGNIFICANT 

where: 

ercode,tl 

is the location of a BCD word identifying the error dis- 
covered by the program, 
messag 

is the location of the first of a pair of BCD words that de- 
scribe the error (e.g., INPUT FORMAT). 

This calling sequence causes the following message 
to be typed: 

( ercode,tl ) ( messag ) ERROR ON S.Sxxx, nnnnn 
The five octal digits nnnnn form the machine ad- 
dress of the device in error. 

The prefix pfx determines the action taken by ioop 
after the message has been typed. The possibilities are: 

pfx 

= PZE Control is returned to the calling program by 

a TRA 3,4. 
= MZE Control is returned to the calling program by 

a TRA 4,4. 
= PON or The job is terminated. 
MON 

The last word of the calling sequence is not sig- 
nificant, because it is impossible for an error return to 
be taken or a special routine to be scheduled by ioder. 



Input/Output Devices 

A single, device-oriented, select and error-recovery 
routine is used by ioop to perform all of the reading, 
writing, non-data-transmitting, error detection, and 
error-recovery operations necessary for each device. 
The following sections describe the operations allowed 
by these routines for the various kinds of input/output 
units. 

729/7330 Magnetic Tape Units 

The length of each record written on magnetic tape 
by ioop is equal to the number of words indicated in 
the parameter specified by the user's calling sequence. 



If the record on tape is longer than the number of 
words specified for a read operation, transmission 
ceases when the required number of words has been 
read, but tape motion continues, until the interrecord 
gap at the end of the record is reached. If the record 
being read contains fewer than the number of words 
specified, transmission ceases when the interrecord gap 
is reached. If the tape is being read or written through 
an online 1401, the size of the 1401 buffer limits the 
record size. The user can determine the number of 
words transmitted to a magnetic tape unit on channels 
a-e by examining s.ssch:. This method cannot be used 
for magnetic tape units attached to the on-line 1401, 
however, because the Store Channel information is 
erroneous for these devices. 

NON-DATA-TRANSMITTING OPERATIONS 

The following non-data-transmitting operations may 
be used with 729/7330 Magnetic Tape units: 

1. Space the tape forward over / file marks and then 
over r physical records. 

2. Space the tape backward to the beginning of this 
file. 

3. Space the tape backward over r physical records. 

4. Place the unit in position to read the (r + l)th 
record of the current file. 

5. Rewind the tape. 

6. Rewind and unload the tape. 

7. Write a file mark on the tape. 

SEQUENCES OF OPERATIONS 

Certain combinations of reading, writing, and back- 
spacing operations may result in errors. The table in 
Figure 9 shows the possible combinations and the 
results of each. In this table, R n stands for "read record 
n," W„ stands for "write record n," B„ stands for "back- 
space over record n," Rew stands for "rewind the tape," 
and S stands for "write blank tape." (ioop has no call 
for a "write blank tape" operation.) 

No check for a valid sequence of operation is made 
by ioop. It is the responsibility of the programmer to 
ensure that his program does not violate any of the 
rules given above. 

ERROR CONDITIONS 

The error conditions that may be encountered with 
magnetic tape and the actions taken to correct them 
are: 

Tape Redundancy While Reading: If the record in 
error is not a noise record, i.e., is three words or longer, 
the tape is backspaced over the record and the record 
is reread. If there is still an error, this procedure is 
repeated nine more times. If this has no effect, if no 
noise records have been read previously, and if at least 
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Can be 




Operation 


Performed 


Remarks 


Reading after Writing: 






1. WriRn + 1 


No 




2. WnBnRn 


Yes 




3. WnBnRnWn+1 


No 


A. The change from 
reading to writing 
causes stray bits in the 
interrecord gap. Re- 
cord n + 1 may be un- 
readable. 


4. WnBnRnSWn+1 


Yes 


B. Only allowed if a 




(729 unit) 


noise record detection 
routine is used (as it 
is with IOOP). 




No 


Unerased tape longer 




(7330 unit) 


than 17 characters re- 
mains in the interrecord 
gap- 


5. WnBnRnRn+1 


No 




Writing after Reading: 






1. RnWn+J 


No 


See Remark A. 


2. RnSWn+1 


Yes 

(729 unit) 

No 
(7330 unit) 


See Remark B. 


3. RnBnWn 


Yes 

(729 unit) 

No 
(7330 unit) 


See Remark B. 


Rewinding: 






1. RnRewRlR2 • • • Rn-lRiT 


Yes 




2. WnRewRlR2 . . . Rn-lRn 


Yes 




3. WnRewRlR2... Rn-1 


No 




RnRn + 1 






4. WnRewRiR2-- , Rn-l 


No 


See Remark A. 


RnWn + 1 






5. WnSRewRlR2...Rn-l 


Yes 


See Remark B. 


RnSWn+1 


(729 unit) 

No 
(7330 unit) 





Figure 9. Sequences of Operation on Magnetic Tape Units 



three records have already been read, the tape is back- 
spaced over three records, to pass the record in error 
under the tape cleaner. Ten more attempts to read the 
record follow this tape cleaner procedure. If, after ten 
tape cleaner procedures, i.e., 101 attempts to read the 
record, the record still has not been read properly, the 
error is considered permanent. This error is indicated 
to the calling program by an error return. 

To avoid unnecessary rereads, an attempt is made to 
read the record in the opposite mode (i.e., bcd or 
binary) after three attempts to read the record in the 
original mode have failed. If this fourth attempt is 
successful, the record is accepted and an indication 
of the alternate mode is placed in s.ssch. If it is un- 



successful, the error-recovery procedure is continued 
in the original mode. 

Tape Redundancy While Writing: The tape is back- 
spaced over the record in error, and a .second attempt 
is made to write this record. If this attempt is unsuc- 
cessful, the tape is backspaced again and blank tape is 
written. An attempt is made to write the record on the 
new piece of tape thus reached. If this attempt is 
unsuccessful, the tape is backspaced and blank tape 
is written again. After a total of 25 write-blank-tape 
operations, i.e., 27 unsuccessful attempts to write the 
record, the error is indicated to the calling program 
by an error return. ' 

Incomplete Word While Reading: Two attempts are 
made to read the record. If the condition persists, it is 
indicated to the calling program by an error return. 

Incomplete Word While Writing: The error is indi- 
cated to the calling program by an error return. 



1301 Disk Storage or 7320 Drum Storage 

The ioop level of iocs provides for system operation 
with either 1301 Disk Storage or 7320 Drum Storage; 
therefore, any reference to disk storage in the follow- 
ing section also applies to 7320 Drum Storage, unless 
otherwise stated. 

ibm 1301 Disk Storage units can be used through 
ioop in two distinct ways: sequential access and ran- 
dom access. 

SEQUENTIAL ACCESS 

When loop is used to read and write sequentially on 
disk storage, the track and record addresses specified 
in the system control block and unit control block are 
incremented automatically. The user who is writing 
sequentially or reading sequential records originally 
written by ioop can program in essentially the same 
way that he would for. magnetic tape, largely ignoring 
the special characteristics of disk storage. The major 
differences between sequential access use of disk 
storage and sequential use of magnetic tape are the 
record length limitations of disk storage and the sym- 
bolic unit limits. Sequential access can be used with 
three methods of operation: single record, full track 
with addresses, and cylinder mode. 

The method of use of disk storage is specified in the 
system control block ( described in the section "System 
Control Blocks"). The number of words that may be 
written in a given record, track, or cylinder is specified 
by the format track for the cylinder. If a record to be 
written exceeds this maximum, the extra words are not 
written (i.e., the record is truncated to the maximum 
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possible size). Disk storage being read or written in 
cylinder mode must have a format of exactly 465 words 
per track. Drum Storage being read or written in 
cylinder mode must have a format of exactly 530 words 
per track. If an entire cylinder is not required for the 
block, the next track is used to begin the next cylinder 
operation. When formatting, one additional word 
should be provided in single-record and cylinder mode 
record areas to include the buffer control word. Full 
track operations write the buffer control word in the 
record address. 

The end-of -medium bit in s.ssch is set and the erret 
exit is taken to indicate that n or fewer tracks remain 
unused on the symbolic unit, where n is an installation 
assembly parameter. (The publication IBM 7040/7044 
Operating System (16/32K): Systems Programmers 
Guide, Form C28-6339, contains detailed information 
on installation assembly parameters.) The number of 
tracks that remain is determined by the mode of op- 
eration of the disk or drum. In full-track mode or 
single record mode, exactly n tracks remain; in cylinder 
mode, n or fewer tracks remain. 

Normally n is set to 4, allowing the writing of an 
alternate buffer, a file mark, a trailer label, and another 
file mark. If this end-of-medium indication is ignored 
and the program continues to write on the unit, the 
program error return is taken when an attempt is made 
to write beyond the last track assigned to the unit. 

NON-DATA-TRANSMITTING OPERATIONS 

When disk storage is used sequentially, the following 
non-data-transmitting operations may be used: 

1. Space forward over / file marks and then over r 
physical records (the physical record may be either a 
track or a single record, depending on system control 
block specifications). 

2. Space backward to the beginning of this file. 

3. Space backward r physical records. 

4. Place the unit in position to read or write the 
(r+l)th record of the current file. 

5. Rewind the unit (reposition to the beginning of 
this symbolic unit, as defined by the limits in the sys- 
tem contro3>bIock)< 

6. Unload the unit. This operation causes an opera- 
tor message to be typed. 

.7. Write a file mark on the unit. This operation 
causes the writing of a record that is recognizable to 
ioop as a file mark when it is read. 

RANDOM ACCESS 

Facilities exist in ioop for reading and writing on disk 
storage in random access fashion. When disk storage 
is used in this way, a slightly modified version of the 



standard calling sequence must be used. This calling 
sequence is: 

* TSX S.IOOP.4 

oper ioparm,tl 

pfxl S.Sxxx,t2,order 

pfx2 erret,t3,sprtn 

The only difference between this calling sequence 

and the standard one is that the decrement of the 

third word (order) contains the address of the first of 

a pair of words with the following contents: 

Wordl 

S, 1-11 contains a two-character order for the 7631 File Con- 
trol. These orders are described in detail in the reference 
manual, IBM 1301 Disk Storage with IBM 7000 Series Data 
Processing Systems. Form D22-6576-2. One of the following 
orders must be used: 

82 — Prepare to verify, single record 

83 — Prepare to write, format track 

84 — Prepare to verify, track with no addresses 

85 — Prepare to verify, cylinder operation 

88 — Prepare to verify, track with addresses 

89 — Prepare to verify, home address 

21-35 contains the binary true address that is converted to 
BCD to perform the seek. 

Word 2 

S: If this bit is a 1, a write check is performed. If it is a 
0, no write check is performed. 

1: If this bit is a 1, special procedure is performed for no 
record found. If it is a 0, the standard procedure is performed. 
Both of these procedures are described under "Error Condi- 
tions/' the next section. 

2-35 is the BCD verification address, of the form TTTTRR. 

The six-bit mode is used for all operations. 

The channel command specified in the calling se- 
quence by ioparm,tl, is used by ioop as the data trans- 
mission command, not as the command to transmit 
orders for device control. Such commands are gener- 
ated internally for the appropriate File Control orders. 



ERROR CONDITIONS 

The various error conditions that may be encountered 
in the use of disk storage, and the actions taken to 
correct them, are described below: 



error(s) 
Invalid Sequence 
Invalid Code 
Format Check 
Response Check 
Data Compare Check 
Parity Check 
Access Not Ready 
Circuit Check 
No Record Found 
Invalid Address 



No Record Found 
(Special Procedure) 



CORRECTIVE ACTION 

The entire sequence is repeated up 
to four times. If the error persists, 
it is indicated to the calling pro- 
gram by an error return. 



The entire sequence is repeated up 
to four times. After the fifth at- 
tempt to transmit data, a recalibra- 
tion procedure is initiated. The 
sequence is then repeated four 
more times. If the error persists, it 
is indicated to the calling program 
by an error return. 
The entire sequence is repeated 
up to four times. If the error per- 
sists, it is indicated to the calling 
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program by an error return; ( The 
use of this procedure may be 
specified only when disk storage is 
being used in random access 
fashion. See bit 1 of the second 
of the device orders specified by 
the calling sequence. ) 

Not Available Type operator message. 

Access Inoperative 
Upon the completion of a disk storage operation, the 
following bits are set in s.ssns: 



S.SSNS BIT 


MEANING 


3 


Program Check 


4 


Data Check 


5 


Exceptional Condition 


6 


Invalid Sequence 


7 


Invalid Code 


8 


Format Check 


9 


No Record Found 


10 


Invalid Address 


11 


Response Check 


12 


Data Compare Check 


13 


Parity Check 


14 


Access Inoperative 


15 


Access Not Ready 


16 


1301 Circuit Check 


17 


7631 Circuit Check 



1402 Card Read Punch 

The maximum length of a physical record on a 1402 
Card Read Punch is 80 bcd characters or 27 binary 
words. Bits 24-35 of word 27 are not transmitted when 
a record is written; they are set to zero when a record 
is read. An output block of more than 27 words is 
truncated to that length. 

NON-DATA-TRANSMITTING OPERATIONS 

The following non-data-transmitting operations may 
be used with the 1402 Card Read Punch: 

1. Write a file mark on the punch. This operation 
causes the feeding of one card. If the operation is 
given for the card reader, the program error is indicated 
to the calling program by an error return. 

2. Rewind the unit. This operation causes no ac- 
tivity. 

3. Rewind and unload the unit. This operation 
causes an operator message to be typed. 

ERROR CONDITIONS 

The only 1402 error conditions that can be detected by 
ioop are hole count, 1402 parity errors, and channel 
check. They are indicated to the calling program by 
an error return. 

1403 Printer 

Three models of 1403 can be connected to an ibm 
7040/7044 Data Processing System. The 1403 Model 1 
has a maximum print record size of 100 bcd characters 
and a speed of 600 lines per minute. The Model 2 



has a maximum print record size of 132 bcd charac- 
ters and a speed of 600 lines per minute. The Model 3 
also has a print line' 132 characters long, but its maxi- 
mum speed is 1,100 lines per minute. If the user tries 
to write a print record longer than the maximum size 
allowed by the printer he is using, the record is trun- 
cated when the maximum number of words has been 
printed. 

NON-DATA-TRANSMITTING OPERATIONS 

The following non-data-transmitting operations may 
be used with the 1403 Printer: 

1. Write a file mark. This operation causes the ejec- 
tion of the page (skip to a punch in channel 1). 

2. Rewind the unit. This operation causes no ac- 
tivity. 

3. Rewind and unload the unit. This operation causes 
an operator message to be typed. 

Before a record is written on a 1403 Printer, the first 
six bits of the first word of the record are examined. 
These six bits, which constitute the first character of 
the print line, are assumed to be a carriage control 
character intended for the printer. The following char- 
acters are translated into 1403 characters when they 
are encountered: 

b (blank) or + Normal single space before printing. 

One extra space before printing 

( double spacing ) . 
— Two extra spaces before printing 

( triple spacing ) . 

These characters are translated into the proper 1403 
carriage control characters and are used with a control 
instruction to obtain properly spaced output. 

The user may also use the actual 1403 carriage con- 
trol characters, listed in Figure 10, in the first char- 
acter position of the record. 

If the first character of the print line is not a blank, 
plus sign, zero, or minus sign, it is assumed to be a 
valid 1403 carriage control character and is used un- 
checked and untranslated. It is the responsibility of 
the user to ensure that there is actually a valid charac- 
ter in this position. 

After the carriage control character has been trans- 
mitted to the 1403, it is changed to a blank while the 
record is printed and is restored afterward. 

ERROR CONDITIONS 

The only 1403 error conditions that can be detected by 
ioop are print timing, 1403 parity errors, and channel 
check. They are indicated to the calling program by 
an error return. 

1622 Card Read Punch 

The 1622 Card Read Punch reads and writes 80-char- 
acter bcd records. If a request is made to ioop to write 
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Immediate 
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Character 
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Channel 1 


A 


Channel 1 


2 


Channel 2 
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Channel 2 


3 


Channel 3 
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Channel 3 


4 


Channel 4 


D 


Channel 4 


5 


Channel 5 


E 


Channel 5 


6 


Channel 6 


F 
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7 
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G 


Channel 7 


8 


Channel 8 


H 


Channel 8 


9 


Channel 9 


1 


Channel 9 


(not allowed) 


Channel 10 


? (12-0 punch) 


Channel 10 


= (8-3 punch) 


Channel 11 


.(12-8-3 punch) 


Channel 11 


* (8-4 punch) 


Channel 12 


) (12-8-4 punch) 


Channel 12 




Immediate 




Space after 




Space 




Printing 


J 


1 space 


/ (0-1 punch) 


1 space 


K 


2 spaces 


S 


2 spaces 


L 


3 spaces 


T 


3 spaces 



Figure 10. 1403 Carriage Control Characters 



a record more than 80 characters long, the record is 
truncated to 80 characters when it is written. A request 
for a binary operation on the 1622 results in a program 
error return. 

NON-DATA-TRANSMITTING OPERATIONS 

The following non-data-transmitting operations may 
be used with the 1622 Card Read Punch: 

1. Write a file mark on the punch. This operation 
causes the feeding of one card. If the operation is 
given for the card reader, the program error is indi- 
cated to the program by an error return. 

2. Rewind the unit. This operation causes no activity. 

3. Rewind and unload the unit. This operation 
causes an operator message to be typed. 

ERROR CONDITIONS 

The possible 1622 errors, i.e., hole count and 1622 
parity errors, cannot be detected by ioop. If such an 
error occurs and a second request is made for an op- 
eration on the unit, a ready message is typed and ioop 
enters a loop to await operator intervention. If a chan- 
nel check occurs, the error is indicated to the calling 
program by an error return. 

1009 Data Transmission Unit 

The ibm 1009 Data Transmission Unit reads or writes 
messages that the ibm 1414 Input/Output Synchro- 
nizer separates into 80 character segments. The user's 
routine must reblock the input segments to obtain one 



message. The user's routine must make a separate 
entry to ioop for each segment of an output message. 
If a request is made to ioop to write a message segment 
more than 80 characters long, the segment is truncated. 
A request for a binary output operation on the 1009 
results in a program error return. 

NON-DATA-TRANSMITTING OPERATIONS ( OUTPUT ONLY) 

The following non-data-transmitting operations may 
be used with the 1009 Data Transmission Unit: 

1. Write a file mark. This operation causes an oper- 
ator message to be typed. 

2. Rewind the unit. This operation causes an opera- 
tor message to be typed. 

3. Rewind and unload the unit. This operation 
causes an operator message to be typed. 

ERROR CONDITIONS 

The error conditions that may be encountered with 
the 1009 Data Transmission Unit are: 

1. Input errors. The error is indicated by setting the 
message error flag in the input buffer (bpflg). 

2. Lost message. The error is indicated by setting 
the lost message flag in the input buffer. 

3. Output transmission error. An error in transmis- 
sion is indicated to the calling program by an error 
return. The user may transmit the message two addi 
tional times. 

4. Output channel check. Two attempts are made to 
fill the buffer. If the condition persists, it is indicated 
to the calling program by an error return. 

1011 Paper Tape Reader 

The maximum length of a physical record on an ibm 
1011 Paper Tape Reader is 80 bcd characters; bits 
12-35 of word 14 are set to zero. A request for binary 
operations on the 1011 results in a program error re- 
turn. It is the user's responsibility to ensure that the 
translation of 5-track or 8-track code to bcd representa- 
tion is made by the 1011. The end of data must be 
recognized by the user, since the 1011 does not send 
an end-of -file signal. A subsequent call to read the 
device will result in a request to ready the unit. 

The 1011 is considered to be a unit record device 
with calling sequences and error returns identical to 
those for a bcd card reader. 

NON-DATA-TRANSMITTING OPERATIONS 

The following non-data-transmitting operations may 
be used with the 1011. 

1. Rewind the unit. This operation causes no ac- 
tivity. 

2. Rewind and unload the unit. This operation 
causes an operator message to be typed. 
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ERROR CONDITIONS 

The error conditions that may be encountered with 
the 1011 Paper Tape Reader are: 

1. Input transmission. An error in transmission is 
indicated to the calling program by an error return. 

2. Channel check. An error in data transfer from , 
the 1414 to core storage is indicated to the calling 
program by an error return. 

1014 Remote Inquiry Unit 

The maximum length of a physical record on an ibm 
1014 Remote Inquiry Unit is 80 bcd characters. If a 
request is made to ioop to write a message more than 
80 characters long, the message is truncated. The first 
character transmitted is the address (0 through 9) 
of the individual unit. A request for a binary output 
operation on the 1014 results in a program error return. 

NON-DATA-TRANSMITTING OPERATIONS ( OUTPUT ONLY ) 

The following non-data- transmitting operations . may 
be used with the 1014 Remote Inquiry Unit: 

1. Rewind the unit. This operation causes an opera- 
tor message to be typed. 

2. Rewind and unload the unit. This operation 
causes an operator message to be typed. 

ERROR CONDITIONS 

The error conditions that may be encountered with the 
1014 Remote Inquiry Unit are: 

1. Input errors. The error is indicated by setting the 
message error flag in the input buffer (bpflg). 

2. Output transmission error. An error in transmis- 
sion is indicated to the calling program by an error 
return. 

3. Output channel check. Two attempts are made 
to fill the buffer. If the condition persists, it is indi- 
cated to the calling program by an error return. 

Telegraph Input/Output Unit 

The telegraph input/output unit reads and writes 80 
character bcd records. If a request is made to ioop to 
write a message more than 80 characters long, the 



message is truncated. A request for a binary output 
operation on telegraph equipment results in a program 
error return. 

NON-DATA-TRANSMITTING OPERATIONS ( OUTPUT ONLY) 

The following non-data-transmitting operations may 
be used with telegraph equipment: 

1. Rewind the unit. This operation causes an opera- 
tor message to be typed. 

2. Rewind and unload the unit. This operation 
causes an operator message to be typed. 

ERROR CONDITIONS 

The error conditions that may be encountered with 
telegraph equipment are: 

1. Input errors. The error is indicated by setting 
the message error flag in the input buffer (bpflg). 

2. Lost message. The error is indicated by setting 
the last message flag in the input buffer. 

3. Output transmission error. An error in transmis- 
sion is indicated to the calling program by an error 
return. 

4. Output channel check. Two attempts are made 
to fill the buffer. If the condition persists, it is indi- 
cated to the calling program by an error return. 

1401 Data Processing System 

In conjunction with the 1401 Input/Output Control 
Program, ioop uses the on-line 1401 as though it were 
an intermediate buffer between 7040/7044 core stor- 
age and the unit addressed. The limitations, non-data- 
transmitting operations, and error-recovery procedures 
for each device are essentially the same as those that 
exist when the device is attached to a 1414 Input/ 
Output Synchronizer. The following devices can be 
read from or written on, using ioop, when they are 
attached to an on-line 1401: 

1. Up to six 729 or 7330 Magnetic Tape Units 

(maximum record length: 370 words) 

2. A 1402 Card Read Punch 

3. A 1403 Printer 



36 



Input/Output Executor (IOEX) 



The Input/Output Executor (ioex) consists of a chan- 
nel scheduler, a program scheduler, a cpu trap super- 
visor, and a collection of utility routines. 

The channel scheduler controls the order in which 
input/output operations are performed on each of the 
channels. 

The program scheduler determines the order in 
which programs and routines are executed by the com- 
puter. It can be used in conjunction with the channel 
scheduler to perform real-time or random processing. 

The cpu trap supervisor takes action on the various 
kinds of traps that are not caused by input/output 
operations controlled by the channel scheduler. These 
include invalid instruction traps, interval timer traps, 
storage protection violation traps, and storage parity 
error traps. 

Utility routines provide four kinds of conversion 
from binary to BCD or octal and the facilities necessary 
for writing on the console typewriter. 



Applications of IOEX 

Programming of input/output at the ioex level is rec- 
ommended only for the most unusual kinds of input/ 
output operations. Under normal circumstances, only 
operations on devices that are not supported by iocs 
( and real-time applications ) justify direct use of ioex. 
Most* of the facilities (including the scheduling of 
special routines ) that are avaialble at the ioex level 
are also available at the ioop level. 



Use of IOEX 

Figure 11 shows the sequence of routines involved in 
the execution of an input/output operation. Although 
the select and error-recovery routines are shown as 
user-written, this may not always be the case. The user 
may wish to supplement, rather than to replace the 
standard select and error-recovery routines supplied 
with ioop. 

For the purposes of this discussion, the following 
terminology is defined: 

Activity 

Use of a device that makes both the device and the channel 
busy. An activity is internally initiated by a select, sense, or 
control instruction, and is terminated by an end-of-operation 
trap. 



Event 

Use of a device that makes the device busy, but does not 
make the channel busy. An event commences at an end-of- 
operation trap, and is terminated by an attention trap. 

Dormancy 

A special type of event peculiar to real-time input devices. 
It comprises a passive waiting period of indefinite duration and 
a subsequent "active" period that is not internally initiated. 
The event, therefore, is not scheduled, but is initiated by some 
external action, e.g., an attention from an IBM 1014 Remote 
Inquiry Unit. The attention that signals the termination of the 
"active" period (and the state of dormancy) is thus not pre- 
dictable within any given period of time and may not occur. 
Note that a dormant device presents to the computer the ap- 
pearance of being busy, i.e., it cannot be read. 

Operation 

A sequence of events and activities on a particular device, 
such as writing and error correcting a record on magnetic tape, 
punching a card, backspacing several records on" magnetic tape, 
or seeking, writing, and write checking a track on disk storage. 
An operation is initiated and terminated by a series of entries 
to a select and error-recovery routine. 

The following sections describe the functions of 
ioex and the ways in which it can be used by the pro- 
grammer. 



Unit Control Blocks 

During the assembly of the Nucleus, one nine-word 
unit control block is generated for each input/output 
device connected to the computer. For the purposes of 
this discussion, each unit connected to a 1414 Input/ 
Output Synchronizer, a 7631 File Control, Or directly 
to the 7040/7044 is considered to be a device. 

The unit control blocks are generated in order of 
priority of device, and the unit control blocks for each 
channel form a continuous string. When ioex is ready 
to initiate a new operation on a given channel, it scans 
over the unit control blocks of that channel, from high- 
priority devices to low-priority devices, searching for 
a waiting operation. The structure of a unit control 
block is shown in Figure 12. The significance of the 
two-character bit codes is: 

EI 

= if this device is internally initiated (i.e., can be read 
and/or written at will). 

= 1 if this device is externally initiated (i.e., signals when it 
is ready to be read or written). 

DA 

= if this device is assigned to some symbolic unit. 

= 1 if this device is not assigned to any symbolic unit (i.e., 
is not associated with any system control block). 
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RW* 

= if a write or non-data-transmitting operation ( other than 
forward space ) is in progress or has been requested. 

= 1 if a read or forward space operation is in progress or 
has been requested. 

ER* 

= if no event has been requested. 
= 1 if an event has been requested. 

EC** 

= if no event is in progress. 

= 1 if an event is in progress. 
RB — reserved for future use by DS Programming Systems. 



IP 

= if an external interrupt has occurred. 
= 1 if the device is dormant. 

PR** 

= the priority of the special routine. Priorities from to 4 
may be used by the calling program. 

MP** 

= 1 if a device-not-ready message has already been printed 
for this operation. 



♦Inserted by S.XACT. 
♦♦Maintained by select and error-recovery routines. 
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1. UCUNI 



2. UCPOS 



3. UCSEL 



4. UCPRC 



5. UCCRC 



6. UCRXC 



7.UCWXC 



8. UCSTG 



9. UCSEN 



3 4 5h6 7 



9 10 11 12 13 14 



Device sub-address 



15 16 17 



Interface 



Information that defines the position of the device" 



Location of the select and error- 
recovery routine used for this device * 



Number of permanent read errors 
on this device ** 



Number of consecutive attempts to 
recover an error ** 



Number of exception records 
read on this device ** 



Number of exception records written 
on this device ** 



Code indicating the stage that has been 
reached by the current operation on this 
device ** 



Sense data 
for this device 



18 19 20 



r- — ■ — ■■■■ 

Li -i- __ 



21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 



Device select address- 
for BCD operation ■ 



PR 



Effective address of the pointer to 
this unit control block * 



Number of recovered read errors 
on this device ** 



Number of recovered write errors 
on this device ** 



Number of records read on 
this device ** 



Number of records written 
on this device ** 



Location of the entry point to a special 
processing routine for this operation ** 



Reel Serial Number 
(used by IOLS) 



* Inserted by S.XACT. 
** Maintained by select and error -recovery routines. 

Figure 12, Format of the Unit Control Block 



UCRRC 



UCWRC 



UCRDC 



UCWDC 



UCRTN 



UCCSN 



System Data Locations 

In addition to the unit control blocks, ioex uses a 
series of data words to keep track of input/output 
operations. These locations, which may be referred to 
by the user's select and error-recovery routines, are: 

S.XTDT 

contains this trap condition indicators. 

S.XLTP 

indicates the position of the device before the trap occurred. 

S.XSCH 

contains the information that was in the channel register after 
the trap occurred. 
S.XCPS 

is negative if a checkpoint is being taken. 
S.XTPS 

is negative if trapping is inhibited. 
S.XSNSandS.XSNS + 1 

contain the sense data obtained by IOEX before each entry 
to a select plus (activity/event initiation) routine, and before 
each entry to the select minus ( activity/event checking ) routine 
for an activity or event that caused an unusual-end trap. 

Requests for Operations 

The user can request the use of a channel for an opera- 
tion on a given device with the following calling .se- 
quence: 



TSX 

pfx 



S.XACT, 4 

p(ucb), t, selrtn 



where: 

pfx 

§ bit = for a write or non-data-transmitting operation 
(other than forward space). 
= 1 for a read or forward space operation. 

1 bit = if no event is requested. 

= 1 if an event is requested. 

2 bit = for a normal request. 

=r= 1 for a priority request. 
p(ucb), t 

is the location of a pointer to the unit control block of the 
device on which the operation is to be performed. This pointer 
has the form: 









l(ucb) 



S 2 3 



17 18 20 21 



35 



where: 



l(ucb) 

is the location of the first word of the unit control block. 
This word may be an entry in the Symbolic Units Table (the 
prefix, decrement, and tag portions are not used by IOEX ) . 
selrtn 

is the location of the select and error-recovery routine that is 
to be used to initiate and check this operation. 

The s.xact routine places bits S and 1 of pfx, and 
selrtn, in the prefix and decrement positions of word 
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ucsel of the unit control block specified. The fact that 
the decrement of ucsel is nonzero indicates to ioex 
that an operation on this device has been requested* 
Similarly, it should be used by the programmer to 
determine whether or not an operation on the device 
can be requested. The s.xact routine does not check 
to see if an operation is already waiting or in progress, 
and there is no facility available for stacking requests. 
If a request is made for an operation on a unit that 
already has an operation waiting or in progress, this 
previous operation is deleted. Unless he intends to 
delete the waiting operation, the user should wait 
until the decrement of ucsel becomes zero (indicating 
the release of the unit by the previous select and error- 
recovery routine) before entering s.xact with a new 
operation. 

To allow input activity on a real-time (e.g., tele- 
communications input ) device, the user issues a stand- 
ard calling sequence to s.xact, supplying the address 
of his select and error-recovery routine. If desired, the 
standard select routine contained in the ioop2 level of 
iocs may be specified (this address is found in word 
scsel of the system control block for this device). This 
call prepares ioex to accept attention signals from the 
device as requests for operations. When an attention 
occurs, the user's select routine is entered. The select- 
minus portion of this routine should not clear the re- 
quest posted in word ucsel of the unit control block 
by the initial call to s.xact, but should set the device 
dormant (ip bit of ucstg = l). To discontinue real-time 
input activity, the user can call s.xact, omitting field 
selrtn of the calling sequence. 

To request output operations on a real-time device, 
a call to s.xact must be executed for each message, i.e., 
buffer, to be written. 

CHANNEL PRIORITIES 

If the user requires immediate use of a channel for an 
input/output operation, he can make a priority call to 
ioex. This is done, as was stated earlier, by making the 
2 bit of pfx a 1. As each activity required by an oper- 
ation is completed, ioex gives control to the select and 
error-recovery routine to allow checking of the ac- 
tivity. After control is returned to ioex by this routine 
and before the routine is re-entered to initiate the next 
stage of the operation, ioex checks to see if a priority 
operation has been requested on the channel. If this 
is the case, control is passed to the select and error- 
recovery routine for the priority operation immediately 
after all events on the channel have been initiated, so 
that this operation can be initiated. 

The ioex allows for only one priority request at a 
time on a given channel. If a priority request is made 
before a previous priority operation has been com- 
pleted, the first priority operation is interrupted in the 



same way that a normal operation would have been. 
Consequently, it is urged that priority requests to ioex 
be used for real-time applications only, so that a nor- 
mal program does not interfere with a real-time pro- 
gram that may be operating at the same time. 

If an attention is signaled by an externally initiated 
device, the device is given priority on the channel. 
Any previously requested priority on the channel, either 
by a prior attention or by a priority call to s.xact, is 
canceled. 

DATA CHANNEL TRAPS 

ioex enables the computer to recognize the following 
conditions as causes of data channel traps: 

1. Completion of an activity ( end-operation trap) 

2. Redundancy check while writing 

3. Reading of a file mark 

4. Word parity check 

5. Unusual-end signal from an adapter 

6. Unit-record attention 

7. Attention from an adapter 

The first six types are termed internally initiated 
traps, because they are caused by currently scheduled 
activities and because they are expected to occur when 
the channel ceases to be busy. The seventh condition 
may be internally initiated, if it is the termination of 
an event such as a seek on a disk storage unit, a read 
or write on a unit record device, or a write on a 
telecommunications device. The seventh condition may 
be externally initiated, if its cause is the termination of 
dormancy. This includes an input message waiting on 
a telecommunications device. 

When an attention trap occurs, ioex determines the 
cause of the trap. If it was caused by the termination 
of an event, the event-in-progress (ec) bit is reset in 
the unit control block and, if the channel is busy, con- 
trol is returned to the program that was interrupted, 
internally initiated interrupts are processed when the 
current channel operation has been completed. 

If the trap was caused by the termination of dor- 
mancy, the external interrupt (ip) bit is reset in the 
unit control block, the unit is given channel priority 
and, if the channel is busy, control is returned to the 
program that was interrupted. Externally initiated in- 
terrupts are processed when the current channel ac- 
tivity has been ^completed. 

select and error-recovery routines 

The programmer using the ioex level of iocs must pro- 
vide a select and error-recovery routine 1 for each kind 
of device he will use. The select and- error-recovery 
routine constructs the select instructions, channel com- 
mands, and device orders necessary for each event and 
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activity in a given operation; keeps -track; of. the stage 
that the operation has reached; and examines the re- 
sults of each trap for errors. If a given activity or event 
is unsuccessful, the select and error-recovery routine 
must initiate an error-recovery procedure appropriate 
to the device. 

Whenever ioex enters a select and error-recovery 
routine, storage protection has been released, traps are 
inhibited, index register 1 contains the channel num- 
ber, index register 4 contains the calling linkage, and 
the address portion of the accumulator contains the 
address of the unit control block. If the programmer 
wishes to use index registers 1 or 4, he must save their 
contents and restore them before returning control to 

IOEX. 

When the select and error-recovery routine is en- 
tered, the sign of the accumulator serves as a switch, 
indicating the kind of processing required. If the sign 
is plus, it indicates that the channel is available for the 
initiation of events and activities on the specified de- 
vice (either the beginning of a new operation or the 
continuation of an existing one). If the sign of the 
accumulator is minus, the select and error-recovery 
routine is to check a completed activity or event for 
errors. 

The select and error-recovery routine is divided into 
two sections. One is called select plus and the other is 
called select minus. The considerations affecting each 
of them are discussed separately. 

SELECT PLUS 

When the select plus routine is entered, ioex has left 
in locations s.xsns and s,xsns+i the results of a sense 
instruction on the device to be treated. Select plus 
must determine whether or not the device is ready. If 
it is not, or if, for some other reason, the select plus 
routine is not ready to issue a select instruction for the 
device, control should be returned to ioex by a tea 2,4. 
If the select plus routine specified for a priority opera- 
tion returns by a tra 2,4, the operation loses its prior- 
ity. The entire request can be deleted by zeroing out 
the prefix and decrement of word ucsel in the unit 
control block before returning. When a return is made 
to ioex by a tra 2,4, it enters the select plus routine 
for another device and schedules the first operation 
later. 

If the device is ready, the select plus routine must 
construct the select instruction, channel command, 
and device order required by the current stage of the 
operation. It then returns control to ioex by a tra i,4; 
leaving the select instruction in the accumulator and 
the channel command in the mq. For a non-data- 
transmitting operation, which requires no channel com- 
mand and hence no Reset and Load Channel instruc- 
tion, the mq should be cleared. The ioex executes the 



select instruction and then (if necessary) a Reset and 
Load Channel instruction "for the channel command. 

Certain stages in an operation, such as the sequence 
of "Prepare to Verify" and then "Write Select" oh a 
1301 Disk Storage unit, have timing considerations 
that make separate scheduling of each activity in the 
sequence inefficient. Both of these activities should be 
considered as one stage of the operation, and ioex al- 
lows for multiple entries to the select plus routine to 
allow them to be performed together. 

If the sign of the mq is minus when the select routine 
returns control to ioex, the necessary set of instructions 
is executed immediately and select plus is re-entered 
for another set. On the subsequent entries, the sign of 
the accumulator is not set to plus, nor is the location 
of the unit control block placed in the address portion 
of the accumulator. For devices that require such a 
multiple entry, the select and error-recovery routine 
might begin with a bra/brn switch. This switch would 
be set to bra before control is returned to ioex to have 
the first activity initiated and reset to brn after the 
final entry. 

When trapping is enabled after a multiple entry to 
select plus, s.xtdt, s.xsns, and s.xsns + 1 contain a logical 
or of the results of all activities and events initiated 
by the multiple entry. 

select MINUS 

If the sign of the accumulator is minus when control 
is given to the select and error-recovery routine, an 
end-of -activity trap has occurred. The select minus rou- 
tine must examine the results of the trap (in location 
s.xtdt) and the contents of the channel register (in 
location s.xsch ) to determine whether or not the ac- 
tivity was successful. Entry to select minus after an 
event is conditional unless an unusual end has oc- 
curred. If an unusual end has occurred, sense data is 
to be found in location s.xsns. Channel parity errors 
are handled by the storage parity routine and are not 
communicated to the select minus routine. 

If an error is detected or if the operation requires 
additional activities or events for its completion, select 
minus should record information in the decrement of 
word ucstg in the unit control block that will inform 
select plus of the stage that the operation has reached. 
If an error occurred during a multiple entry to select 
plus, all activities should be considered as one stage 
and the entire sequence should be repeated. 

Select minus routines must maintain the following 
portions of the unit Control block: 

1. The number of consecutive errors, in the decre- 
ment portion of word uccrc \ 

2. The number of exception (e.g:, noise) records, in 
the decrement portion of word ucrxc or word ucwxc 
(reading or Writing) 
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3. The number of permanent read errors, in the dec- 
rement portion of word ucprc 

4. The number of recovered errors, in the address 
portion of word ucrrc or word ucwrc (reading or 
writing ) 

5. The number of records read or written, in the 
address portion of word ucrdc or word ucwdc 

6. The position of the unit, in word ucpos 

The position of a sequential device, as recorded in 
word ucpos of the unit control block, consists of the 
number of file marks written or spaced to, in the dec- 
rement of the word, and the number of records written 
or read since the last file mark, in the address portion 
of the word. 

The device position is defined separately for each 
type of random access device. For 1301 Disk Storage, 
the position of the unit is given by the current head 
and track number, in binary, in the address portion of 
word ucpos. 

As long as more activities or events (i.e., more en- 
tries to select plus ) are required to complete the opera- 
tion, select minus should return to ioex by a tra 1,4. 
If the activity is completed at an end-of -operation trap 
but an event is still in progress, select minus sets a 1 
in the ec bit of word ucsel, indicating that an event 
is in progress, ioex zeroes the ec bit of ucsel when the 
event is completed. When no additional events or 
activities are required, select minus must clear the 
prefix and decrement portions of word ucsel, freeing 
the device for another request, and return control to 
ioex by a tra 2,4. 

The select minus portion of the select and error- 
recovery routine for a real-time input device must set 
the ip bit in the unit control block after a completed 
activity. In no case should select minus clear the pre- 
fix and decrement portions of word ucsel for this type 
of device. 

special routine requests 

Before returning to ioex at the end of an operation, 
select minus can request the execution of a special 
routine. This is done by placing the location of the 
entry point to the special routine in the address portion 
of word ucrtn, and the priority of the routine ( a num- 
ber from zero through four) in the tag portion of the 
word. Control is then returned to ioex by a tra 2,4. For 
a discussion of priorities and scheduling of special 
routines, see the section "Program Scheduling." 

USE OF STANDARD SELECT AND ERROR-RECOVERY ROUTINES 

The user can write routines that assign buffer areas, 
schedule (queue) a particular activity on the unit, 
provide additional error procedures, and then transfer 
control to the standard iocs select and error-recovery 
routine for the device. The location of the entry point 



to the standard select and error-recovery routine is 
the address portion of the word scsel in the system 
control block. This word is described in the section 
"System Control Block" in the chapter "Input/Output 
Operations (ioop)." 

On the select plus entry to the user's routine, if a 
tra 2,4 return to ioex is not to be taken, the user must 
provide the information in locations scopr, scioc, pr, 
scrtn, scdoi, and scd02. If the decrement portion of 
word ucstg is not zero, the operation has begun and 
the intermediate stages are probably of no interest. 
The contents of index registers 1 and 4 and of the alge- 
braic accumulator must be preserved for transfer to the 
standard select and error-recovery routine. 

On the select minus entry to the user's routine, the 
user may save index register 4, and tsx to the standard 
select and error-recovery routine. Index register 1 and 
the accumulator must not be disturbed. If the standard 
select and error-recovery routine returns to 1,4, the 
operation is not complete. The user's routine can re- 
load index register 4 and return to ioex by a tra i,4. 
If the standard select and error-recovery routine re- 
turns to 2,4, the operation is complete, error counts 
and device position have been updated, and the spe- 
cial routine request (if any) is in word ucrtn. Index 
register 1 must be preserved. By examining the contents 
of word scsch in the system control block, the user's 
routine can determine if the operation was completed 
successfully or if a permanent error exists. The user 
may post completion indicators and he may update 
queues. If additional operations on the device are re- 
quired, the user must restore the location of the entry 
point to his select routine in the decrement portion of 
word ucsel, which was cleared by the standard select 
and error-recovery routine when the device was re- 
leased. 

Select routines operate with storage protection re- 
leased. They should not be debugged during system 
runs. Select routines should be short, so that real-time 
processing is not prevented while data channel traps 
are inhibited. 

Channel Scheduling 

The ioex is responsible for scheduling the use of the 
data channels by the devices attached to them. It 
assigns priorities for a given channel in the following 
order: 

1. Entry to the select and error-recovery routine at 
the end of a current activity. 

2. Events to be initiated. 

13. Priority requests to s.xact or externally initiated 
input activities. 

4. More activity on the current operation. 

5. A new operation. 
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When the computer is trapped, the following occurs: 

1. The select minus entry on the current activity is 
always serviced first. Select minus may return to ioex 
with information on the stage reached by the operation. 
Select minus can also return to ioex with a special rou- 
tine request. Entry to select plus to initiate the next 
stage of the operation and entry to the special routine 
may be delayed because of scheduling considerations. 

2. If any events have been requested, ioex enters 
select routines for all events to be initiated on the 
channel. 

3. If a priority request exists, it takes the place of 
any incomplete currently scheduled operation. Thus, 
a currently scheduled operation that is not completed 
may be temporarily discontinued. 

4. The currently scheduled select plus entry is made. 
This will be a continuation of an incomplete operation 
only if no priority request has superseded it. 

5. If there is no currently scheduled operation, the 
unit control blocks for the channel are scanned for a 
new operation. This new operation may be, in fact, 
a resumption of a delayed incomplete operation. 

6. If no new operation is found, the channel is per- 
mitted to become idle. 

If one or more operations on the channel requests 
rescheduling by a 2,4 return from select plus, ioex 
goes into a hold loop until the channel can be reacti- 
vated. The loop is broken for any of the following 
conditions: 

a. Any other channel busy 

b. An event in progress on any channel 

c! An attention from an externally initiated device 
When the hold loop is entered, the following action 
will be taken for a given device: 



Contents 


Enter 

Select 

Plus 


Release 
Hold 
Loop 


Remarks 


El 


EC 


IP 


UCSEL 






1 
1 
1 

1 




1 
1 














1 
1 




sel 



sel 



sel 



sel 


no 

yes 

no 

no 

no 

yes 

no 

no 


no 
yes 
yes 
yes 
no 
yes 
no 
no 


attention, but no request 
request, event completed 
no request, event in progress 
request, event in progress 
attention, but no request 
request, device not dormant 
no request, device dormant 
request, but device dormant 



Program Scheduler 

The program scheduler is the portion of ioex that 
determines the order in which non-trap-time programs 
are executed by the central processing unit. 

When an operation is completed by a given trap, the 
select minus routine can request that a special routine 
be executed. When ioex receives the tra 2,4 return, 
which indicates the end of the operation, and after it 



has initiated a new operation on the channel (if possi- 
ble), it transfers control to the program scheduler. 
* 

Program Priorities 

The program scheduler determines whether or not a 
routine of higher priority than the program in progress 
has been requested by the select minus routine. If so, 
the contents of s.ssch, s.ssns, the location interrupted, 
and the register contents saved by ioex when the trap 
occurred are all stored in a push-down list. Trapping is 
re-enabled, and the new routine is entered by a tsx 
sprtn,4. 

Routines may be assigned any priority from 
through 4. The main program has no priority. Priorities 
5 through 7 are reserved for the system. The length of 
the push-down list, which limits the number of levels 
of priority that can be used effectively, is an assembly 
parameter in the symbolic input for the System Moni- 
tor. If a routine of higher priority than the program 
in progress is requested, but the push-down list is full, 
the higher priority routine is not entered. 

When a routine returns to ioex, the unit control 
blocks are scanned for the highest priority routine 
waiting to be entered. If none of these has a higher 
priority than the latest program placed in the push- 
down list, this program is re-entered at the point at 
which it was interrupted. 

Use of Special Routines 

When a special routine is entered by ioex, index regis- 
ter 4 contains the calling linkage and the address por- 
tion of the accumulator contains the location of the 
first word of the unit control block in which the special 
routine was requested. The address and tag portions 
of word ucrtn of this unit control block have been 
cleared by ioex. 

A special routine may use all levels of iocs; however, 
the iobs and iols levels should not be used if there is 
the possibility that either of them is in use at the time 
that the special routine is executed. A special routine 
can request scheduling of another special routine ( but 
not by placing its address in a unit control block, be- 
cause storage protection has been turned on). Since 
trapping is enabled before the special routine is en- 
tered, it is possible that the special routine may be 
interrupted by another routine of higher priority. For 
this reason, some care should be taken in using in- 
formation from the unit control block through which 
the special routine was called, as another special rou- 
tine may already have requested an* operation on the 
unit and changed the unit control block. 

When the special routine has completed all process- 
ing, it must return control to ioex by a tra 1,4. 
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Deactivation of IOEX 

The symbol s.xdac is the entry point to an ioex sub- 
routine that deactivates all channels for the purpose 
of taking a checkpoint or dump. This subroutine can- 
not be called by a nonstandard select routine. 
The calling sequence to this Bj^utine is: 

TSX S.XDAC,4 

pf x ptr 

where: 

pfx 

= MZE to deactivate all channels and special-routine 
requests. 

= PZE to nullify a previous deactivation and to activate 
all possible channels, 
ptr 

= the location of a pointer to a unit control block of the 
form 

pfx l(ucb),b,c 
in which pfx, b, and c are ignored 
( ptr may be a word in the Symbolic Units Table ) . 

If ptr exists, ioex will permit channel activity for 
this unit only. 

The effect of an mze call to s.xdac is : 

1. A switch is set to prevent any call to a select-plus 
routine except for externally initiated input devices, for 
any operation On the unit specified in ptr, and for any 
activity resulting in an event. 

2. A switch is set to prevent any entry to a special 
routine. 

3. Each channel is tested for a lost trap. If a trap 
was lost, the channel is set inactive, and ucsel cleared 
for the device. 

4. If an activity was requested on the device cor- 
responding to unit ptr and the channel is not active, the 
channel is activated. 

5. A switch is set to prevent holding in ioex for any 
unit except for the device corresponding to unit ptr. 

The effect of a pze call to s.xdac is : 

1. The switches mentioned above are reset. 

2. All channels are activated. 

3. A waiting special routine is entered. 

A call to s.xdac has no effect on calls to select minus 
for end-of-operation or unusual-end traps. 



Central Processing Unit Traps 

The cpu trap supervisor processes traps that are not 
the result of input/output operations. The following 
actions are taken for each variety of trap: 

1. Interval Timer Reset: The job is terminated with 
a dump. 

2. Storage Protect Violation: The job is terminated 
with a dump. 

3. Storage Parity Error: The job is terminated with 
a dump, unless parity trapping was inhibited when 
the error occurred. 



4. Instruction Traps: 

a. Store Location and Trap*— the job is termi- 
nated with at dump. 

b. Floating Point* — the trap is ignored. 

c. Release Protect Mode — if this is a monitor 
violation, the job is terminated with a dump. 

d. Set Protect Mode — the job is terminated with 
a dump. 

5. Interval Timer Overflow*: The job is terminated 
with a dump. 

6. Direct Data Trap*: The trap is ignored. 

The processing of the conditions marked * can be 
changed by substitution of a user-written routine for 
the iocs routine. The program can modify the trap 
transfer location for the particular error by a call to 
s.sccr. The System Monitor restores the standard trap 
transfer each time it is loaded, The return of control 
to the interrupted program is the responsibility of the 
user's routine. No return to ioex should be made. 



Utility Routines 

The ioex contains several utility routines for the con- 
venience of the programmer, These routines include 
several conversion routines and a general typewriter 
routine for operator action messages. 

Conversion Routines 

Four basic conversion routines are provided within 
ioex. They are: 

1. Binary to octal conversion of the data in the ad- 
dress portion of the accumulator. The call is: 



TSX 
Return 



S.XOVA,4 



The result is right-justified in the accumulator. 

2. Binary to octal conversion of the data in the de- 
crement portion of the accumulator. The call is: 



TSX 
Return 



S.XOVD.4 



The result is right-justified in the accumulator. 

3. Binary to decimal conversion of the data in the 
address portion of the accumulator. The call is: 

S.XDVA,4 



TSX 
Return 



The result is right-justified in the mq. 

4. Binary to decimal conversion of the data in the 
decrement portion of the accumulator. The call is: 



TSX 
Return 



S. XDVD, 4 • 
The result is right-justified in the mq. 
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Typewriter Routine fword 

rm n. . .1 . .. . . . is the location of the first word of the message to be typed. 

The calling sequence to the typewriter print routine is: 

TSX S. XPRT, 4 is the number* of BCD characters to be typed. This count is 

PZE fword, , count converted to words before the select instruction is executed, 

where: The typewriter routine ignores errors. 
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Input/Output Label System (IOLS) 



The use of labels is one of the most inexpensive ways 
to prevent avoidable failures of jobs. Label verification 
ensures that the correct files are read, in the right 
sequence, and that valuable information is not de- 
stroyed. Labeling also allows the programmer to treat 
his files in a more general manner than would be 
possible if he had to read or write each reel of mag- 
netic tape or each section of disk storage separately, 
and it reduces the amount of internal housekeeping by 
providing indications of the ends of files and of seg- 
ments of files. 

The Input/Output Label System (iols) performs 
all of the label verification and creation functions re- 
quired for opening and closing, reel switching, and 
forcing the end-of-reel condition on both labeled and 
unlabeled files. It can be used with either the ioop 
level or the ioex level of input/output programming, 
but it requires the presence in core storage of ioop for 
reading and writing labels and for positioning devices. 

Format of Labeled Files 

If iols is to be used on a given file, this file must be 
organized in the following manner: 

1. Beginning of medium indicator (or the end of 
the previous file) 

2. Header label, in bcd mode 

3. File mark 

4. Checkpoint, if any, in binary mode 

5. File mark, if there is a checkpoint 

6. Data blocks, in either bcd or binary mode 

7. File mark 

8. End-of-reel or end-of-file trailer label, in bcd mode 

9. File mark 

In multi-reel files, item 8 is an end-of-reel trailer 
label for each reel except the last one, on which it is 
an end-of-file trailer. If a given unit contains more 
than one file; items 2 through 9 are repeated for each 
file. 

Format of Labels 

The iols verification and creation routines are designed 
to operate with the ibm standard label. The format of 
this label is shown in Figure 13. The standard label 
is 120 characters (twenty 7040 words) long. It is pos- 
sible that the programmer may prefer to create and 
verify his own labels, using iols only for reading and 
writing labels and for unit switching. In this case, iols 
performs no verification or creation of its own. Only 
labels exactly 120 characters long are written, however, 



and any label longer than 120 characters is truncated 
to that length when it is being read into core storage. 

Label Control Block 

In the process of checking labels on input files and 
creating labels for output files, iols uses the labeling 
information supplied by the programmer for each file. 
This information is held in a nine-word label control 
block. When iols is being used as a part of iobs, the 
label control block is part of the file control block 
(words 8-16). The format of the label control block is 
shown in Figure 14. 

The explanation of the two-character bit codes in 
the label control block are: 

OB-Open Status Bit 

— if the file is not open. 

= 1 if the file is open. 
Rl, R2 — These are reserved for future use by DS Programming 
Systems. 
PR — Permissible to Reposition 

= permissible to Reposition at CLOSE 

= 1 do not reposition at CLOSE 
NA*— Nonstandard or Additional Label Processing 

= if the label is a standard IBM label and is to be verified 
by IOCS. If the address in bits 21-35 of this word is not zero, 
this address is the location of the entry point to an additional 
processing routine. 

= 1 if the label is not a standard IBM label and is not to be 
verified by IOCS. The label is read into and written from the 
label area. If the address in bits 21-35 of this word is not zero, 
this address is the location of the entry point to a nonstandard 
verification or creation routine. 
IN-Input 

= if the file is output. 

= 1 if the file is input. 
CI*— Checkpoint Indicator 

= if there are no checkpoints on this file. 

= Ion an input file, if a checkpoint follows the header label 
on each reel of the file and is to be automatically passed over by 
IOLS. 

= 1 on an output file, if a checkpoint is to be written follow- 
ing every header label. 
MI— Mode Indicator 

= if the file is in BCD mode. 

= 1 if the file is in binary mode. 
RS*— Reel Specification 

= if the file is single-reel. 

= 1 if the file is multi-reel. ( 

LI*— Labels Indicator 

= if the file is unlabeled. 

= 1 if the file is labeled. 
SC*— Sequence Check 

= if no block sequence numbers are formed or checked for 
this file. 

= 1 if block sequence numbers are formed or checked for 
this file. 
CC*- Check Sum Check 

= if no check sums are formed or checked for this file. 

= 1 if a check sum is formed or checked for each record 
written or read on the file. 



Field 


Positions 


Field Name 


Description 


Field 


Positions 


Field Name 


Description 


1 


1-5 


Label 


1 HDRb to indicate a header 


11 
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Block Sequence 


This character indicates the 






Identifier* 


label, lEORb to indicate 
an end-of-reel trailer label, 
or lEOFb to indicate an 






Indicator** 


presence (1) or absence (0) 
of .block sequencing. 








end-of-file trailer label. 


12 


48 


Recording Mode 
Indicator** 


This character indicates 
whether the file is in BCD 




6 




Blank. 








(2) or binary (1) mode. 


2 


7-10 


Retention 


The number of days after 


13 


49 


Recording 


This field specifies the num- 






Period* 


the creation date (0000- 
9999) that this file is to 
be retained. 






Technique 
Indicator*** 


ber of bits recorded as 
one byte: 6. 










14 
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Data Processing 


This field specifies the num- 


3 


11-15 


Creation 


The year and day of the 






Technique 


ber of bits to be pro- 






Date* 


year on which the file was 






Indicator*** 


cessed as one byte: 6. 








created. The year occupies 


15 


51-54 


Creating 


This field specifies the sys- 








the first two positions (00- 






System 


tem that created the file. 








99) and the day of the 








Labels created by IOLS 








year occupies the last three 








always have the characters 








positions; e.g., December 








7040 in this field. 








30, 1 963 would be entered 
















as 63364. 


16 


55 


Record 
Format*** 


This character indicates the 
record format found in this 


4 


16-25 


File 
Identification* 


A ten-character field iden- 
tifying the file. 








file. 










17 


56-60 


Record 


For fixed-length records. 


5 


26-30 


File Serial 
Number* 


This field is the same as 
the Reel Serial Number of 
the first or only reel of 
the file. 






Length*** 


this field specifies the num- 
ber of characters in each 
data record; for variable- 
length records, it specifies 
the number of characters 


6 


31-35 


Reel Serial 
Number 


A five-character identifica- 
tion code assigned to the 
reel when it enters the in- 








in the largest possible data 
record in the file. 








stallation. This number nor- 


18 


61-65 


Block Size*** 


For fixed-length records. 








mally appears on the outer 








this field specifies the num- 








surface of the reel for 








ber of data records in each 








visual identification. 








. block; for variable-length 
records, it specifies the 




36 




Blank. 








number of characters in the 


7 


37-40 


Reel Sequence 


A four-digit number (0001- 


x 






largest possible block in 
the file. 






Number* 


9999) that is the order of 














this reel within the file. 


19 


66 


Checkpoint 


This character indicates the 




41 




Blank. 






Indicator** 


presence (1) or absence (0) 
of checkpoints in the file. 


8 


42-44 


Reserved 


This field is reserved for 
future DS Programming 
Systems use. 


20 


67-72 


Block Count* 


This field specifies the num- 
ber of blocks written on 
this reel of the file (ex- 


9 
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Density 
Indicator*** 


This field specifies the den- 
sity change that is neces- 
sary before the file is read: 








cluding labels, checkpoints, 
and file marks). The block 
count is given in trailer 
labels only. 








— The body of the file is 














in the same density as 


21-26 


73-100 


Reserved 


These fields are reserved 








the label. 








for future DS Programming 








The 7040 cannot process 








Systems use. 








files written in varying 
















densities. 


27 


101-120 


For Optional 
Use*** 


Positions 101 through 120 
may be employed as an 


10 


46 


Check Sum 
Indicator** 


This character indicates the 
presence (1) or absence (0) 
of check sums. 






. • 


area for additional label 
data, at the option of the 
user. v s - ; 



♦This field is verified by IOLS. 

**This field overrides and replaces the corresponding label control block 

specifications. 
***This field is not interpreted by IOLS. 

Figure 13. Format of the Standard Label 
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21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 



1. LCUNI 



2. LCFCN 



3. LCCON 



4. LCBSN 



5. LCFSN 



6. LCRSN 



7. LCRET 



8. LCID1 



9. LCID2 



Address of Symbolic Units Table entry 
of the secondary unit * 



Address of Symbolic Units Table entry 
of the pr i rirfa ry u n i t * 



sserved 



Address of a nonstandard or additional 
label processing routine * 




Available to the user 



Available to the user 



Number of blocks read or written on 
this unit * 



File serial number, in BCD, of the form OXXXXX 



Reel sequence number, in BCD, of the form 00XXXX 



For an output file, the retention period (days) in BCD, of the form 00XXXX 
For an input file, the file creation date in BCD, of the form OXXXXX * 



First six characters of the BCD file identification, of the form XXXXXX * 



Last four characters of the BCD file identification, of the form XXXX00 * 



Fields marked with an * must be set before any IOLS routine is used. 

Figure 14- Format of the Label Control Block 



Fields marked with an * must be set before any iols 
routine is used. If the decrement of word lcuni is zero, 
the primary unit is used as the secondary unit. 
If s.sini, s.soui, or s.sppi is the primary unit, the sec- 
ondary unit field should be either zero or the same 
as the primary unit field. Unit switching on these three 
units is always completely automatic. 



Calling Sequence 

The same general calling sequence is used to call all 
four iols routines. It is written as: 



TSX 


S.IOLS, 4 


oper 


lcb, t, label 


pfx 


erret, , mode 


retl 




ret2 





where: 

oper 
is one of the following four operation codes: 
ILOPN Open the file. 

ILRSW Switch reels. 

ILFER . Force the end-of-reel condition. 

ILCLS Close the file. 

The actions taken by IOLS for each kind of operation are de- 
tailed later. 

Icb.t 

is the location of the label control block for the file. 



label 

is the location of a 120-character buffer provided by the pro- 
grammer for the use of IOLS. Any labels that must be read into 
core storage for this operation, and all labels that are created 
and written out, use this buffer. 

pfx 

= PZE if the unit is to be rewound before each header label 
is read or written and after each trailer label is read or written. 

= PTW if the unit is to be rewound and unloaded after the 
trailer label is read or written. 

= MZE if all repositioning is to be omitted. 

= MON if^both repositioning and verification or creation are 
to be omitted. 

erret 

is the location of an error routine, written by the user. If 
erret is left blank (zero) and an error is encountered, IOCS 
pauses and allows the operator to exercise his discretion as to 
the disposition of the invalid label. 

mode 

is an expression of the form A+4*B, where: 
A = 1 for binary files, 2 for BCD files 
B = 1 for input files, 2 for output files 

retl and ret2 

are the locations to which control is returned after the speci- 
fied operation has been completed. The return taken varies with 
the conditions encountered. 

The mode bits in this calling sequence override the 
corresponding bits in the label control block. Either or 
both of them may be left blank, however, ^nd the label 
control block is then left unchanged. 
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Label System Operations 

The following sections describe the four operations 
provided by iols. The procedures used for verifying 
and creating labels are described later, in the section 
"Label Verification and Creation." The label control 
block is modified according .to the specifications of the 
calling sequence before any of the following operations 
is executed. 



Open the File (ILOPN) 

The iqls operation code ilopn may be used to open 
labeled or unlabeled, input or output files. The steps 
taken for each kind of file are detailed below. 

LABELED INPUT FILE 

1. The unit is repositioned according to the speci- 
fications of the calling sequence. 

2. The header label is read into core storage and 
verified. If the label is invalid, the invalid-label return 
(erret) is taken. 

3. The file mark following the header label is passed 
over. 

4. If the label control block indicates that a check- 
point follows the header label, this checkpoint and 
the file mark following it are passed over. 

5. Control is returned to retl. 

UNLABELED INPUT FILE 

1. The unit is repositioned according to the specifi- 
cations of the calling sequence. 

2. If the label control block indicates that the reel 
begins with a checkpoint, this checkpoint and the file 
mark following it are passed over. 

3. Control is returned to retl. 

LABELED OUTPUT FILE 

1. The unit is repositioned according to the specifi- 
cations of the calling sequence. 

2. If the unit has been rewound, the existing header 
label is read into core storage to verify that the re- 
tention period has expired (this process is described 
in "Output Unit Header Label" in the section "Label 
Verification and Creation"). If the retention period has 
not expired, the file is presumably still valid and should 
not be overwritten. If the user attempts to open an 
output file with a reel containing a still-valid file, opera- 
tor intervention is required. 

.3. The unit is backspaced over the old header label. 

4. A new header label is created from the data in 
the label control block and is written out. 



5. A file mark is written. 

6. If the label control block specifies a checkpoint 
at the beginning of each reel, this checkpoint is written, 
followed by a file mark. 

7. Control is returned to retl. ' 

UNLABELED OUTPUT FlLE 

1. The unit is repositioned according to the specifi- 
cations of the calling sequence. 

2. If the unit has been rewound, the existing header 
label is read into core storage to verify that the reten- 
tion period has expired. If the retention period has not 
expired, the file is presumably still valid and should 
not be overwritten. If the user attempts to open an 
output file containing a still-valid file, operator inter- 
vention is required. 

3. The unit is backspaced over the header label. 

4. If the label control block specifies a checkpoint 
at the beginning of the reel, this checkpoint is written, 
followed by a file mark. 

5. Control is returned to retl. 

If the file was already open, control is returned to 
retl. 

Switch Reels (ILRSW) 

The iols operation code ilrsw may be used to switch 
reels on an input file, either labeled or unlabeled, after 
a file mark has been read. 

LABELED INPUT FILE 

1. If the label is nonstandard and no nonstandard 
processing routine is specified, the label control block 
is examined to determine whether or not the file is 
multi-reel. 

2. The trailer label is read into core storage and 
verified. If the label is invalid, the invalid-label return 
(erret) is taken. 

3. If the label indicates that the end of the data file 
has been reached, no reel switching is necessary. The 
file mark following the trailer label is passed over and 
control is returned to retl. If the trailer indicates the 
end of the reel, the unit is repositioned according to the 
specifications of the calling sequence. If the unit is 
not to be rewound, the file mark following the trailer 
label is passed over. 

4. The iols determines the alternate unit from the 
label control block. If no alternate is specified, a mes- 
sage is typed requesting that a new reel be mounted 
on the same unit. 

5. The alternate unit or the new reel on the same 
unit is rewound. \ 

6. The header label on the new reel is read into 
core storage and verified. If the label is invalid, the 
invalid-label return (erret) is taken. 
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7. The file mark following the header label is passed 



over. 

8. If the label control block indicates that a check- 
point follows the header label, this checkpoint and the 
file mark following it are passed over. 

9. Control is returned to ret2. 

UNLABELED INPUT FILE 

1. If the label control block specifies that the file 
is single-reel, control is returned to retl. 

2. If the label control block specifies that the file 
is multi-reel, the unit is repositioned according to the 
specifications of the calling sequence. 

3. The iols determines the alternate unit from the 
label control block. If no alternate is specified, a mes- 
sage is typed requesting that a new reel be mounted 
on the same unit. 

4. The alternate unit or the new reel on the same 
unit is rewound. 

5. If the label control block indicates that the reel 
begins with a checkpoint, this checkpoint and the file 
mark following it are passed over. 

6. Control is returned to ret2. 

If the file is closed, the program error return (erret) 
is taken. 

Force End-of-Reel Condition (ILFER) 

The iols operation code ilfer may be used to switch 
reels on labeled or unlabeled, input or output files. The 
steps taken for each kind of file are detailed below: 

LABELED INPUT FILE 

1. The unit is repositioned according to the specifi- 
cations in the calling sequence. 

2. The iols determines the alternate unit for the file 
from the label control block. If no alternate unit is 
specified, a message is typed requesting that a new 
reel be mounted on the same unit. 

3. The alternate unit or the new reel on the same 
unit is rewound. 

4. The header label on the new reel is read into core 
storage and verified. If the label is invalid, the invalid- 
label return (erret) is taken. 

5. The file mark following the header label is passed 
over. 

6. If the label control block indicates that a check- 
point follows the header label, this checkpoint and the 
file mark following it are passed over. 

7. Control is returned to retl. 

UNLABELED INPUT FILE 

1. The unit is repositioned according to the specifi- 
cations of the calling sequence. 

2. The iols determines the alternate unit for the file 
from the label control block. If no alternate is speci- 



fied, a message is typed requesting that a new reel be 
mounted on the same unit. 

3. The alternate unit or the new reel on the same 
unit is rewound. 

4. If the label control block indicates that the reel 
begins with a checkpoint, this checkpoint and the file 
mark following it are passed over. 

5. Control is returned to retl. 

LABELED OUTPUT FILE 

1. A file mark is written. 

2. An end-of-reel trailer label is created, using data 
from the label control block. This label is written, fol- 
lowed by a file mark. 

3. The unit is repositioned according to the specifi- 
cations of the calling sequence. 

4. The iols determines the alternate unit for the file 
from the label control block. If no alternate unit is 
specified, a message is typed requesting that a new 
reel be mounted on the same unit. 

5. The alternate unit or the new reel on the same 
unit is rewound. 

6. The existing header label is read into core storage 
to verify that the retention period has expired. If the 
retention period has not expired, the file is presumably 
still valid and should not be overwritten. If the user 
attempts to open an output file with a reel containing 
a still-valid file, operator intervention is required. 

7. The unit is backspaced over the old header label. 

8. A new header label is created from the data in 
the label control block and is written out. 

9. A file mark is written. 

10. If the label control block specifies a checkpoint 
at the beginning of each reel, this checkpoint is written, 
followed by a file mark. 

11. Control is returned to retl. 

UNLABELED OUTPUT FILE 

1. A file mark is written. 

2. The unit is repositioned according to the specifi- 
cations of the calling sequence. 

3. The iols determines the alternate unit for the file 
from the label control block. If no alternate unit is 
specified, a message is typed requesting that a new 
reel be mounted on the same unit. 

4. The alternate unit or the new reel on the same 
unit is rewound. 

5. The existing header label is read into core storage 
to verify that the retention period has expired. If the 
retention period has not expired, the file is presumably 
still valid and should not be overwritten. If the user 
attempts to open an output file with a reel containing 
a still-valid file, operator intervention is required. 

6. The unit is backspaced over the old header label. 
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7. If the label control block specifies a checkpoint 
at the beginning of each reel, this checkpoint is written, 
followed by a file mark. 

8. Control is returned to retl. 

If the file is closed, the program error return (erret ) 
is taken. 

Close the File (ILCLS) 

The iols operation code ilcls may be used to close 
labeled or unlabeled, input or output files. The steps 
taken for each kind of file are detailed below. 

LABELED INPUT FILE 

1. The unit is repositioned according to the speci- 
fications of the calling sequence. 

2. Control is returned to retl. 

UNLABELED INPUT FILE 

1. The unit is repositioned according to the specifi- 
cations of the calling sequence. 

2. Control is returned to ret 1. 

LABELED OUTPUT FILE 

1. A file mark is written. 

2. An end-of-file trailer label is created, using data 
from the label control block. This label is Written, 
followed by a file mark. 

3. The unit is repositioned according to the speci- 
fications of the calling sequence. 

4. Control is returned to refl. 

UNLABELED OUTPUT FILE 

1. A file mark is written. 

2. The unit is repositioned according to the specifi- 
cations of the calling sequence. 

3. Control is returned to ret 1. 

If the file is closed, the unit is repositioned accord- 
ing to the specifications of the calling sequence and 
control is returned to retl. 



Label Verification and Creation 

To fill the label verification and creation requirements 
of the four major operations, iols treats five distinct 
kinds of labek It verifies header and trailer labels from 
input files, checks the header labels on files that are 
about to be overwritten to ensure that the retention 
period has expired, and creates header and trailer 
labels for output files. Each of these procedures is de- 
scribed below. 

Input File Header Label 

Whenever an input file is opened and at the beginning 
of each reel of multi-reel file, the header label is 
verified to ensure that the correct reel is being proc- 



essed. The following conditions must be met if the 
label of an input file is to be considered valid: 

1. The label identifier must be lHDRb. 

2. The file creation date, in word lcret of the label 
control block, must agree with the creation date in the 
label, Field 3. This, condition is considered to have 
been met if the label control block word is zero. 

3. The file identification, in words lcidi and lcid2 
of the label control block, must agree with the file 
identification in the label, Field 4. This condition is 
considered to have been met if the label control block 
words are both zero. 

4. The file serial number, in words lgfsn of the 
label control block, must agree with the file serial 
number in- the label, Field 5. This condition is con- 
sidered to have been met if the label control block 
word is zero. 

5. The reel sequence number, in word lcrsn of the 
label control block, must agree with the reel sequence 
number in the label, Field 7. This condition is con- 
sidered to have been met if the label control block 
word is zero. 

Unless all of the above conditions are satisfied, an 
invalid-label return (erret) is taken. The invalid-label 
return is described in the section "Error Procedures" 
in this chapter. 

If any of the control information (i.e., check sum 
indicator, block sequence indicator, recording mode 
indicator, or checkpoint indicator) in a valid label con- 
tradicts the information found in the label control 
block, the label information replaces that in the label 
control block. If the unit is rewound, the block count 
in word lbcsn of the label control block is set to zero. 

Input File trailer Label 

At the end of each file and at the end of each reel of a 
multi-reel file, the trailer label is inspected. The fol- 
lowing conditions must be met if this label is to be 
considered valid: 

1. The label identifier must be either lEOFb or 

lEORb. 

2. The block count, in Field 20 of the label, must 
agree with the number of blocks read, in word lcbsn 
of the label control block. This condition is considered 
to have been met if the label control block Word is zero. 

If either of the above conditions is not met, an 
invalid-label return (erret) is taken. 

Output Unit Header Label 

Through the use of a System Monitor assembly param- 
eter, each installation is allowed to specify whether or 
not the existing header labels on outputs units are to 
be checked for retention information before writing 
begins. This step has been included in the descriptions 
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of opening and forcing the end-of-reel condition on 
output files. All programs should use iols for output 
reel handling, even if the files being created do not 
contain labels. 

The following conditions must be met if a unit is to 
be used: 

1. The label identifier must be lHDRb. 

2. The retention period must have expired. This 
is verified by checking the retention period (Field 2 
of the label ) and the file creation date ( Field 3 of the 
label) against the current date, in location s.sdat+i. 

If either condition is not met, a message is typed 
requesting operator action. The operator may choose 
to use the reel, to replace the reel with another (on 
which the label is also verified ), or to terminate the job. 

Output File Header Label 

When ilopn or ilfer are used on labeled files, header 
labels are created and written. These labels are cre- 
ated in the following manner: 

1. The label identifier is lHDRb. 

2. The following information is inserted in the label 
from information contained in the label control block: 

Retention Period-Field 2-from word LCRET 
File Identifier-Field 4-from words LCID1 and LCID2 
File Serial Number-Field 5-from word LCFSN 
Reel Sequence Number— Field 7— from word LCRSN 
Check Sum Indicator-Field 10-from word LCCON 
Block Sequence Indicator— Field 11— from word LCCON 
Recording Mode Indicator— Field 12— from word LCCON 
Checkpoint Indicator— Field 19— from word LCCON 
Block Count-Field 20-from word LCBSN 

3. The following information is also placed in the 
label: 

Creation Date-Field 3-from location S.S DAT + 1 - 
Reel Serial Number— Field 6— from the previous header 

label on the same unit 
Density Indicator— Field 9— always 
Recording Technique Indicator— Field 13— always 6 
Data Processing Technique Indicator— Field 14— always 6 
Creating System— Field 15— always 7040 

4. Fields 8, 16, 17, 18, and 21 through 27 are always 
blank. If the unit is rewound, the block count in word 
lcbsn of the label control block is set to zero. 

Output File Trailer Label 

When ilfer or ilcls is used on labeled files, trailer 
labels are created and written on the old output unit. 
These labels are created in the following manner: 

1. If the operation is ilfer, the label identifier is 
lEORb. If the operation is ilcls, it is lEOFb. 

2. The information that was placed in the header 
label is also placed in the trailer label. 

3. The block count from word lcbsn is placed in the 
block count field of the label, Field 20. 



Nonstandard and Additional Label Processing 

The label control block can specify the location of a 
routine, written by' the user, that provides label proc- 
essing in addition to or instead of the standard iocs 
routines. If nonstandard or additional processing is 
specified for the labels on.a given file, the programmer 
must provide for the processing of all of the different 
kinds of labels that can appear on that file, except out- 
put unit header labels that are to be overwritten. 

A nonstandard label may have either a rearrange- 
ment of the standard label format or an entirely dif- 
ferent format. The iols still performs all of the actions 
associated with each iols operation, except label veri- 
fication and creation. Control is transferred to the 
user's routine whenever verification or creation of a 
label is required. 

Additional label processing involves the creation and 
verification of fields in the optional use portion of the 
standard 120-character label (positions 101-120). If 
additional label processing is specified, the user's rou- 
tine is executed immediately after the iols creation or 
verification routine. Although provision must be made 
for processing each kind of label that can appear on 
the file, this provision may consist of no more than an 
immediate return without any actual processing. Such 
returns should always be made by a tra 2,4. 

Input File Header Labels: The following calling se- 
quence is used to transfer control to the user's non- 
standard or additional label processing routine for 
input file header labels: 



TSX 
PZE 



lrt,4 
lcb, , label 



where: 

lrt 

is the location of the entry point to the programmer s label 
processing routine, 
lcb 

is the location of the first word of the label control block, 
label 

is the location in core storage of the first word of the label. 

If the programmer's routine finds the label valid, it 
should return control to iols by a tra 2,4. If the label 
is invalid, the return is made by a tra 3,4. Following 
nonstandard verification, the checkpoint indicator in 
the label control block must be set if a checkpoint is 
to be passed over. ( 

Input File Trailer Labels: The following calling se- 
quence is used to transfer control to the user's non- 
standard or additional label processing routine for 
input file trailer labels: 

TSX lrt+1,4 

PZE lcb,, label 

If a nonstandard label processing routine finds that 
a label is an end-of-reel trailer ( i.e., indicates that unit 
switching is required ) , it should return to iols by a 
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tra 2,4. Since additional processing routines are only 
called for trailer labels with a ieord identifier, the 
tra 2,4 return should be used, unless the additional 
processing routine finds other information which in- 
dicates that the end of the data file has been reached. 
At the end of the data file, both nonstandard and addi- 
tional routines should return by a tra 3,4. 

Output File Header Labels: The following calling 
sequence is used to transfer control to the user's non- 
standard or additional label processing routine for 
output file header labels : 

TSX lrt+2,4 

PZE lcb,, label 

Return should be made by a tra 2,4. 

Output File Trailer Labels: The following calling 
sequence is used to transfer control to the user's non- 
standard or additional label processing routine for 
output file trailer labels: 

TSX lrt+3, 4 

PZE lcb, , label 

Return should be made by a tra 2,4. 

The contents of index registers 1 and 2 must be 
saved and restored by the user's nonstandard or addi- 
tional label processing routines. 



Error Procedures 

When any discrepancy is found in a label, either the 
calling program or the operator is allowed to make 
additional verification. If an error routine has been 
specified in the calling sequence to iols, this routine 
is called to process most label errors. If no routine has 
been specified, operator intervention is allowed for 
certain correctable errors. Certain errors can be 



handled only by the operator. See the iols decision 
table, Figure 15, for a summary of label error proce- 
dures. The following calling sequence is used by iols 
for error routines: 



TSX erret, 4 

pfx lcb, , label 

BRN *■ Icall (used only if pfx- 
or MZE) 



PZE 



where: 

pfx 

= PZE if an error exists in the calling sequence to IOLS. 

= MZE if the end of the medium was reached before IOLS 
could write an output file trailer label or while it was writing 
an output file header label. 

= PON if a file mark or a redundancy occurred in the read- 
ing of a header label. If the error was a file mark, the label 
area is cleared before the error routine is called. 

= MON if a file mark or a redundancy occurred in the 
reading of a trailer label. If the error was a file mark, the label 
area is cleared before the error routine is called. 

= PTW if a header label was found to be invalid. 

= MTW if a trailer label was found to be invalid. 

lcb 

is the location of the first word of the label control block for 
the file, 
label 

is the location of the first word of the label area. 
Icall 

is the two's complement of the location of the calling sequence 
to IOLS (given for pfx = PZE and MZE only). 

The error routine is called for the following pro- 
gram errors: 

1. A calling sequence in which lcb is zero. 

2. A calling sequence in which label is zero. 

3. A calling sequence in which oper is not a recog- 
nizable code. 

4. A call for ilrsw on an unopened file or on an 
output file. 

5. A call for ilfer on an unopened file or on a file 
on which no primary unit is specified. 



Operation 


Type of 
File 


Trailer Label 


Header Label 


Always 


Redundant 


Invalid 


1EOF 


1EOR 


Redundant 


Invalid 


Valid 


ILOPN 


Input 










erret 
(PON) 


erret 
(PTW) 


retl 




Output 










Operator Action Only 


retl 




ILRSW 


Input 


erret 
(MON) 


erret 
(MTW) 


retl 


Check 
Header 


erret 
(PON) 


erret '- 
(PTW) 


ret2 _ 




Output 
















erret 
(PZE) 


ILFER 


Input 










erret 
(PON) 


erret 
(PTW) 


retl 




Output 








(written) 


Operator Action Only 




retl 


ILCLS 


Input 














^ 


retl 


Output 






(written) 










reH 



Figure 15. The iols Decision Table 
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If no error routine has been specified and either 
an erroneous calling sequence ( pfx — pze ) is encoun- 
tered or the end of the medium is reached while writ- 
ing an output label (pfx = mze), the job is termi- 
nated. Any return to iols by a tra 2,4 or a tra 3,4 from 
a routine processing such errors also results in termi- 
nation. 

In the case of an input header label ( pfx = pon or 
ptw), a return by a tra 2,4 accepts the reel; while a 
return by a tra 3,4 causes the reel to be unloaded. In 
the case of an input trailer label (pfx = mon or mtw), 
a return by a tra 3,4 causes the end-of-data-file proce- 
dure to be executed, whereas a return by a tra 2,4 
causes the end-of-reel procedure to be executed. 



If the error is in an input header or trailer label 
and no error return has been specified, an operator 
message is typed,' along with the label in error, the 
label expected, and instructions for .operator options. 
The operator may, under sense switch control, exercise 
the same options that are available to the program. 
Discrepancies in output unit header labels (unexpired 
retention periods) always require operatior action. 

If iols is called for a file on which no primary unit 
is specified in the label control block (i.e., if this field 
is zero), the call is ignored if the operation is ilopn or 
ilcls, and results in an end-of-data-file return if the 
operation is ilrsw. 
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1401 Input/Output Control Program (IOCP) 



The 1401 Input/Output Control Program (iocp) has 
been written to provide users of ibm 7040/7044 Data 
Processing Systems with easy access to input/output 
units connected to the 7040/7044 through an on-line 
1401. The iocp is designed to allow such input/output 
devices to be used as though they were connected to 
the 7040/7044 by a 1414 Input/Output Synchronizer. 
The iocp stays in a ready loop, awaiting a select in- 
struction from the 7040/7044. When such an instruc- 
tion is executed, it is brought into the 1401 and trans- 
lated into the 1401 instructions necessary to perform 
the desired operation. The iocp can read and/or write 
records on any of the following devices in accordance 
with instructions from the 7040/7044: 

Up to six 729/7330 Magnetic Tape Units 
A 1402 Card Read Punch 
A 1403 Printer 

Since the maximum size of magnetic tape records 
that can be written by the iocp is a function of the 
core storage size of the 1401 and the amount of space 
occupied by the iocp itself, the iocp does not contain 
any error correction routines. Instead, it notifies the 
7040/7044 of any errors that have occurred, and the 
program in control there must attempt error recovery 
by the appropriate procedures. 

If a device connected to the 1401 is sensed when 
the iocp is not in its ready loop, the first bit in the first 
byte of sense data is set on, indicating that the device 
is not ready. 

The following sections describe the treatment of the 
various devices by the iocp. 



729/7330 Magnetic Tape 

The following select instructions can be used for mag- 
netic tarie units connected to the on-line 1401: 

Read BCD 

Read Binary 

Write BCD 

Write Binary 

Write Blank Tape 

Write File Mark 

Backspace One Record 

Rewind 

Rewind and Unload 

Sense 

The 7040/7044 and the 1401 are interlocked both 

while data is being transmitted to or from the 1401 

and while it is being read from or written on the tape. 

If an error occurs, the iocp does not attempt to correct 



it; instead, it turns on the channel A redundancy indi- 
cator. 

The Write Blank Tape, Write File Mark, Backspace 
One Record, Rewind, and Rewind and Unload instruc- 
tions interlock the 7040/7044 and the 1401 only long 
enough to allow the iocp to interpret them. The 7040/ 
7044 is then allowed to proceed with its processing, and 
the iocp executes the appropriate 1401 instruction be- 
fore returning to its ready loop. The Write Blank Tape 
instruction must be followed by a Reset and Load 
Channel instruction in the 7040/7044, although no data 
is transmitted. The iocp issues an Erase Tape instruc- 
tion, but the blank tape section is not actually written 
until the next Write instruction for the same tape unit 
is executed. 

Tape records may not exceed 370 7040/7044 words 
in length. An attempt to write a record longer than 
this results in the loss of the additional words. 

Unless the iocp is out of the ready loop, there can 
be no bits in the first byte of sense data for a mag- 
netic tape unit on the 1401. The tape is considered 
ready if the iocp is ready. 



7402 Card Reader 

The following select instructions are allowed for the 
card reader of a 1402 Card Read Punch connected to 
the on-line 1401: 

Read BCD 
Read Binary 
Sense 

Except for the reading of the first card, the iocp is 
always one card ahead of the 7040/7044. This allows 
the iocp to transmit a card image as soon as one is 
requested, without having to wait for the actual read 
operation to take place. This results in a minimum of 
interlock time, since the only nonoverlapped operation 
is the transmission of the qata from the 1401 to the 
7040/7044. The 7040/7044 can then continue process- 
ing, while the iocp reads another card before return- 
ing to its ready loop. Cards read without error are 
stacked in Pocket 1. 

The 7040/7044 can test the status of the card cur- 
rently held in the 1401 by executing .a sense instruction 
on the card reader. If no card has yet been read, the 
sense instruction yields a unit-busy indicator and the 
1401 proceeds to read a card. 
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The significance of the bits in the first byte of sense 

data is: 

Sbit 
lbit 
2bit 

3 bit Unit is busy 

4 bit No more cards to be read ( end of file ) 

5 bit Data is binary 
No bits Data is BCD 

There can be no combinations of these bits. 



1402 Card Punch 

The following select instructions are allowed for the 

card punch of a 1402 Card Read Punch connected to 

the on-line 1401: 

Write BCD 
Write Binary 
Sense 

The 7040/7044 and the 1401 are interlocked only 
during the transmission of data to the 1401. The 7040/ 
7044 can then continue processing, and the iocp 
punches the card before returning to its ready loop. 
Cards punched without error are stacked in pocket 4. 

There can be no bits in the first byte of sense data 
for the punch. If the iocp is ready, the punch is as- 
sumed to be ready. 



7403 Printer 

The following select instructions are allowed for the 

1403 Printer connected to the on-line 1401: 

Write BCD 

Control 

Sense 



The 7040/7044 and the 1401 are interlocked only 
during the transmission of data to the 1401. The 7040/ 
7044 can then continue processing, and the iocp prints 
the line before returning to its ready loop. 

A control select of the printer causes' one word to be 
transmitted to the 1401. The iocp uses the first six bits 
of this word as a carriage Control character for a Con- 
trol Carriage instruction. The following check is made 
of this character: 

J is ignored 

K is changed to J 

L is changed to K 

The only bit that can be on in the first byte of sense 
data for the 1403 Printer is bit 3, which indicates that 
the printer is busy. 



Invalid Select Instructions 

If the iocp receives a select instruction that it cannot 
interpret, the 7040/7044 and the 1401 interlock, while 
the iocp tries to reread the select instruction. If the 
reread is successful, processing continues normally. 
If the rereading fails to produce an instruction that the 
iocp can accept, it enters a loop and waits for the opera- 
tor to set a sense switch on the 1401 console. 

If sense switch G is turned on, the iocp halts. The 
operator can then press the start-reset button, caus- 
ing the invalid select instruction to be discarded. 
Processing resumes in both computers. 

If sense switch F is turned on, the iocp itself discards 
the invalid select instruction. Processing then resumes 
in both computers. 
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